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