FindResourceEx

ฟังก์ชันFindResourceExกำหนดตำแหน่งที่ตั้งของทรัพยากร ด้วยการระบุชนิด ชื่อ และภาษาในโมดูลที่ระบุ.

(HRSRC FindResourceEx HMODULE  hModule, / / จัดการทรัพยากรโมดูลLPCTSTRlpType, / / พิมพ์ตัวชี้ไปยังทรัพยากรLPCTSTRlpName, / / ชี้ไปที่ชื่อของทรัพยากรWORDwLanguage / / ทรัพยากรภาษา ) 

พารามิเตอร์

hModule

จัดการไปยังโมดูแฟ้มปฏิบัติการได้ประกอบด้วยทรัพยากร ถ้าพารามิเตอร์นี้เป็นค่า NULL ฟังก์ชันการค้นหาโมดูลที่ใช้ในการสร้างกระบวนการปัจจุบัน.

lpType

ชี้เป็นสายอักขระค่า null ที่สิ้นสุดจ้างระบุชื่อชนิดของทรัพยากร สำหรับข้อมูลเพิ่มเติม ให้ดูที่ข้อสังเกต สำหรับชนิดมาตรฐานทรัพยากร พารามิเตอร์นี้สามารถเป็นหนึ่งในค่าต่อไปนี้:

ค่า	ความหมาย
RT_ACCELERATOR	ตารางการเร่งความเร็ว
RT_ANICURSOR	เคอร์เซอร์เคลื่อนไหว
RT_ANIICON	ไอคอนภาพเคลื่อนไหว
RT_BITMAP	บิตแมปทรัพยากร
RT_CURSOR	ทรัพยากรของเคอร์เซอร์ขึ้นอยู่กับฮาร์ดแวร์
RT_DIALOG	กล่องโต้ตอบ
RT_FONT	ทรัพยากรแบบอักษร
RT_FONTDIR	แบบอักษรไดเรกทอรีทรัพยากร
RT_GROUP_CURSOR	ทรัพยากรฮาร์ดแวร์อิสระเคอร์เซอร์
RT_GROUP_ICON	ทรัพยากรฮาร์ดแวร์แบบไม่ขึ้นกับไอคอน
RT_HTML	เอกสาร HTML
RT_ICON	ทรัพยากรไอคอนขึ้นอยู่กับฮาร์ดแวร์
RT_MENU	ทรัพยากรของเมนู
RT_MESSAGETABLE	รายการข้อความแบบตาราง
RT_RCDATA	ทรัพยากรที่โปรแกรมประยุกต์กำหนด (ข้อมูลดิบ)
RT_STRING	รายการตารางสตริ
RT_VERSION	รุ่นของทรัพยากร

lpName

ชี้เป็นสายอักขระค่า null ที่สิ้นสุดจ้างระบุชื่อของทรัพยากร สำหรับข้อมูลเพิ่มเติม ดูข้อสังเกต.

wLanguage

ระบุภาษาของทรัพยากร ถ้าพารามิเตอร์นี้คือ MAKELANGID (LANG_NEUTRAL, SUBLANG_NEUTRAL), ภาษาปัจจุบันเกี่ยวข้องกับหัวข้อการเรียกใช้.

เมื่อต้องการระบุเป็นภาษาอื่นที่ไม่ใช่ภาษาปัจจุบัน ใช้แมโคMAKELANGIDเพื่อสร้างพารามิเตอร์นี้ ดูข้อมูลเพิ่มเติม MAKELANGID.

ส่งกลับค่า

ถ้าฟังก์ชันสำเร็จ ค่าส่งกลับเป็นตัวจัดการกับทรัพยากรที่ระบุข้อมูลบล็อก เพื่อขอรับตัวจัดการทรัพยากร ผ่านหมายเลขอ้างอิงนี้ไปยังฟังก์ชันLoadResource.

ถ้าฟังก์ชันล้มเหลว ส่งคืนค่าเป็น NULL การขอเพิ่มเติมข้อมูลข้อผิดพลาด โทร GetLastError.

หมายเหตุ

ถ้าสูงคำของพารามิเตอร์lpTypeหรือlpNameเป็นศูนย์ ต่ำคำระบุตัวระบุจำนวนเต็มของชนิดหรือชื่อของทรัพยากรที่ระบุ มิฉะนั้น พารามิเตอร์เหล่านี้เป็นตัวชี้การสิ้นสุดด้วย null สาย ถ้าอักขระแรกของสตริงที่เป็นเครื่องหมายปอนด์ (#), อักขระที่เหลือแสดงตัวเลขทศนิยมที่ระบุตัวระบุจำนวนเต็มของชื่อหรือชนิดของทรัพยากร ตัวอย่าง "# 258" สายอักขระการแทนตัวระบุจำนวนเต็ม 258.

แอปพลิเคชันควรลดจำนวนหน่วยความจำที่จำเป็นสำหรับทรัพยากร โดยอ้างอิงเหล่านั้นโดยการระบุจำนวนเต็มแทนตามชื่อ.

เมื่อเสร็จสิ้นการใช้ตารางการเร่งความเร็ว บิตแมป เคอร์เซอร์ ไอคอน หรือเมนู คุณสามารถปล่อยของหน่วยความจำที่เกี่ยวข้อง โดยการเรียกฟังก์ชันหนึ่งในตารางต่อไปนี้.

ระบบลบทรัพยากรเหล่านี้โดยอัตโนมัติเมื่อกระบวนการที่สร้างขึ้นดังกล่าวสิ้นสุดลง อย่างไรก็ตาม เรียกฟังก์ชันเหมาะสมช่วยประหยัดหน่วยความจำ และเป็นลดขนาดของชุดการทำงานของกระบวนการ.

โปรแกรมประยุกต์ที่สามารถใช้FindResourceExในการค้นหาชนิดของทรัพยากรใด ๆ แต่ควรจะใช้ฟังก์ชันนี้เท่านั้นถ้าโปรแกรมประยุกต์ต้องเข้าถึงข้อมูลทรัพยากรไบนารีเมื่อทำการต่อมาเรียกไป ฟังก์ชันระบุว่า LoadLibraryและLockResource.

การใช้ทรัพยากร ทันที แอปพลิเคชันควรใช้ฟังก์ชันเฉพาะทรัพยากรต่อไปนี้เพื่อค้นหา และโหลดทรัพยากรในการเรียกเพียงหนึ่งครั้ง:

ตัวอย่าง แอปพลิเคชันสามารถใช้ฟังก์ชันLoadIconเพื่อโหลดไอคอนสำหรับการแสดงผลบนหน้าจอ อย่างไรก็ตาม แอพลิเคชันควรใช้FindResourceExและLoadResourceถ้ามันจะโหลดไอคอนเพื่อคัดลอกข้อมูลไปยังโปรแกรมประยุกต์อื่น.

สายทรัพยากรจะถูกเก็บไว้ในส่วนของสายอักขระที่ 16 แต่ละส่วน สายอักขระในแต่ละส่วนจะถูกเก็บไว้เป็นลำดับของสายนับ(สิ้นสุดไม่เป็น null ด้วย) อักขระ Unicode LoadStringฟังก์ชันจะแยกสายทรัพยากรจากส่วนสอดคล้องกัน.

QuickInfo

nbsp Windows &NT:ต้องการเวอร์ชัน 3.1 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ไม่สนับสนุน
หัวข้อ:ประกาศใน winbase.h
ไลบรารีที่นำเข้า:ใช้ kernel32.lib
Unicode:นำมาใช้เป็น Unicode และ ANSI รุ่นบน Windows และ Windows NT.

ดูเพิ่มเติม

ภาพรวมของทรัพยากรฟังก์ชันทรัพยากร FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadString, LoadResource, MAKELANGID

Index