הפונקציה ExtractIcon מאחזר נקודת אחיזה לסמל קובץ ההפעלה שצוין, ספריית קישור דינאמי (DLL) או קובץ הסמל.
כדי לאחזר את מערך של נקודות האחיזה כדי סמלים גדולים או קטנים, השתמש בפונקציה ExtractIconEx.
(HICON ExtractIcon HINSTANCE hInst, / / המופע אחיזהLPCTSTRlpszExeFileName, / / שם הקובץ של קובץ עם הסמלUINTnIconIndex / / אינדקס של סמל כדי לחלץ);
אם ערך זה – 1, הפונקציה מחזירה את המספר הכולל של סמלים בקובץ שצוין. אם הקובץ הוא קובץ הפעלה או קובץ DLL, הערך המוחזר הוא מספר המשאבים RT_GROUP_ICON. אם הקובץ הוא.ICO קובץ, הערך המוחזר הוא 1.
Windows 95, Windows NT 4.0 ואילך: אם ערך זה הוא מספר שלילי, לא שווה ל-1, הפונקציה מחזירה נקודת אחיזה על סמל בקובץ שצוין מזהה המשאב שאת שווה לערך המוחלט של nIconIndex. לדוגמה, השתמש-3 שטח כדי לחלץ את סמל שאת מזהה המשאב הוא 3. כדי לחלץ את סמל שאת מזהה המשאב הוא 1, השתמש בפונקציה ExtractIconEx.
הערך המוחזר הוא נקודת אחיזה לסמל. אם הקובץ שצוין היה לא קובץ הפעלה, קובץ DLL או קובץ הסמל, התשואה היא 1. אם הסמלים לא נמצאו בקובץ, הערך המוחזר הוא NULL.
עליך להשמיד את נקודת האחיזה של סמל המוחזר על-ידי ExtractIcon על-ידי קריאה לפונקציה DestroyIcon.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על shellapi.h.
ייבוא ספריית:השתמש shell32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
סקירה כללית של סמלים, סמל פונקציות, DestroyIcon, ExtractIconEx