ExtractAssociatedIcon

הפונקציה ExtractAssociatedIcon מחזירה מזהה ייחודי סמל אינדקס שנמצאו בקובץ או סמל שנמצאו בקובץ הפעלה המשויך.

(HICON ExtractAssociatedIcon HINSTANCE  hInst, / / יישום המופע אחיזהLPTSTRlpIconPath, / / הוא הנתיב ושם הקובץ של קובץ עבור איזה סמל / שניהLPWORDlpiIcon / / מצביע לאינדקס סמל);
 

פרמטרים

hInst
מציין את המופע של היישום קורא לפונקציה.
lpIconPath
המצביע למחרוזת המציינת את הנתיב המלא ואת שם הקובץ של קובץ שעבורו רצויה סמל. הפונקציה מחלצת את נקודת האחיזה של סמל קובץ זה, או מתוך קובץ הפעלה המשויכת לקובץ זה.

אם נקודת האחיזה של הסמל שהתקבל מקובץ הפעלה, הפונקציה מאחסן את הנתיב המלא ושם הקובץ של הפעלה זו במחרוזת הצביע על-ידי lpIconPath.

lpiIcon
המצביע מילה המציינת את האינדקס של הסמל של נקודת האחיזה שלו היא ניתן להשיג.

אם נקודת האחיזה של הסמל שהתקבל מקובץ הפעלה, הפונקציה מאחסן מזהה הסמל את המילה הצביע על-ידי lpiIcon.

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר הוא נקודת אחיזה סמל. אם הסמל המופק קובץ הפעלה המשויך, הפונקציה מאחסן את הנתיב המלא ואת שם הקובץ של קובץ ההפעלה במחרוזת הצביע על-ידי lpIconPathומאחסן מזהה הסמל את המילה הצביע על-ידי lpiIcon.

אם הפעולה תיכשל, הערך המוחזר הוא NULL.

הערות

הפונקציה ExtractAssociatedIcon תחילה יחפש את סמל אינדקס בקובץ שצוין על-ידי lpIconPath. אם הפונקציה לא לקבל את נקודת האחיזה של סמל מאותו הקובץ, הקובץ מכיל קובץ הפעלה המשויך, נראה כי קובץ ההפעלה עבור סמל. אסוציאציות של קבצי הפעלה מבוססות על סיומות של שמות קבצים מאוחסנים בחלק לפי משתמש של הרישום, ניתן להגדיר באמצעות הפקודה שותף מנהל הקבצים.

QuickInfo

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

ראה גם

סקירה כללית של סמלים, סמל פונקציות, ExtractIcon

Index