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 מחרוזות עבור כל מקטע. המחרוזות בכל מקטע מאוחסנים כרצף של מחרוזות Unicode שנספרו (לא המסתיימת ב- null). הפונקציה LoadString לחלץ משאב מחרוזת מתוך המקטע התואם שלו.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winbase.h.
ייבוא ספריית:השתמש kernel32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows ו- Windows NT.

ראה גם

מבט כולל על משאבים, פונקציות משאבים, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadString, LoadResource, MAKELANGID

Index