UpdateResource

הפונקציה UpdateResource מוסיף, מוחקת או החלפת משאב קובץ הפעלה.

(BOOL UpdateResource לטפל  hUpdate, / / קובץ העדכון לטפלLPCTSTRlpType, / / סוג כתובת של משאב כדי לעדכןLPCTSTRlpName, / / כתובת של משאב שם כדי לעדכןWORDwLanguage, / / מזהה השפה של המשאבLPVOIDlpData, / / כתובת של נתוני משאביםDWORDcbData / / אורך הנתונים משאבים, בבתים);
 

פרמטרים

hUpdate

ציון של מזהה ייחודי של קובץ העדכון. נקודת אחיזה זו מוחזרת על-ידי הפונקציה BeginUpdateResource.

lpType

מצביע מחרוזת המסתיימת ב- null המציין את סוג משאב כדי להתעדכן. פרמטר זה יכול להיות ערך של מספר שלם חלף למאקרו MAKEINTRESOURCE , או שהוא יכול להיות אחד מהסוגים הבאים של משאבים מוגדרים מראש:

ערך	משמעות
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 המציין את שם המשאב כדי להתעדכן. פרמטר זה יכול להיות ערך של מספר שלם חלף למאקרו MAKEINTRESOURCE.

wLanguage

מציין את מזהה השפה של המשאב שיש לעדכן. לקבלת רשימה של מזהי שפה ראשיים ומזהי sublanguage המרכיבים את מזהה השפה, ראה MAKELANGID מאקרו.

lpData

מצביע נתוני משאבים שתצורף לתוך קובץ ההפעלה. אם המשאב הוא אחד מסוגי מראש, הנתונים חייבים להיות חוקיים ולא מיושר כהלכה. שים לב כי זה נתונים בינאריים גולמיים מאוחסנים בקובץ הפעלה, לא את הנתונים שסופקו על-ידי LoadIcon, LoadString, או פונקציות אחרות של טעינת משאב ספציפי. כל הנתונים המכיל מחרוזות או טקסט חייב להיות בתבנית Unicode; lpData לא חייב להצביע הנתונים ANSI.

אם lpData הוא NULL, המשאב שצוין יימחקו קובץ ההפעלה.

cbData

מציין את הגודל בבתים של נתוני משאבים ב- lpData.

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

אם הפעולה תיכשל, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError.

הערות

ליישום יש אפשרות להשתמש UpdateResource שוב ושוב כדי לבצע שינויים בנתונים משאב. כל קריאה ל- UpdateResource תורמת לרשימה פנימית של הוספות, מחיקות ושינויים החלפות, אך לא למעשה לכתוב את הנתונים לקובץ ההפעלה. היישום חייב להשתמש בפונקציה EndUpdateResource כדי לכתוב את השינויים שהצטבר לקובץ ההפעלה.

QuickInfo

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

ראה גם

מבט כולל על משאבים, המשאב מתפקד, BeginUpdateResource, EndUpdateResource, LoadIcon, LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource

Index