ExtractAssociatedIcon

Funkcja ExtractAssociatedIcon zwraca uchwyt ikona indeksowanych znaleziono w pliku lub ikona w skojarzonym pliku wykonywalnego.

(HICON ExtractAssociatedIcon Wystąpienie HINSTANCE  hInst, / / aplikacji instancji uchwytLPTSTRlpIconPath, / / ścieżka i nazwa pliku dla których ikony / / chciałLPWORDlpiIcon / / wskaźnik myszy na ikonę indeksu);
 

Parametry

hInst
Określa wystąpienie aplikacji wywołanie funkcji.
lpIconPath
Wskaźnik na ciąg, określa pełną ścieżkę i nazwę pliku, dla którego ikona jest pożądane. Funkcja wyodrębnia uchwyt ikony z tego pliku lub plik wykonywalny skojarzone z tym plikiem.

Jeśli uchwyt ikony jest uzyskiwany z plikiem wykonywalnym, funkcja przechowuje pełną ścieżkę i nazwę tego pliku wykonywalnego w ciągu wskazywanego przez lpIconPath.

lpiIcon
Wskaźnik do programu WORD , który określa indeks ikonę, której dojście jest uzyskanie.

Jeśli uchwyt ikony jest uzyskiwany z plikiem wykonywalnym, funkcja przechowuje tę ikonę identyfikator w programie WORD wskazywanego przez lpiIcon.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest dojście do ikony. Jeśli ikona jest wyodrębniana z skojarzony plik wykonywalny, funkcja przechowuje pełną ścieżkę i nazwę pliku wykonywalnego w ciągu wskazywanego przez lpIconPathi zapisuje identyfikator ikony w programie WORD wskazywanego przez lpiIcon.

Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL.

Uwagi

Funkcja ExtractAssociatedIcon szuka najpierw ikonę indeksowane w pliku określonym przez lpIconPath. Jeżeli funkcja nie może uzyskać uchwyt ikony z tego pliku, a plik ma skojarzony plik wykonywalny, szuka w tym pliku wykonywalnego dla ikony. Skojarzenia z plików wykonywalnych oparte są na rozszerzeniach, są przechowywane w części użytkownika rejestru i mogą być definiowane za pomocą polecenia Skojarz Menedżera plików.

Skrócone informacje

nbsp; Windows &NT: wymaga wersji 3.5 lub nowszej.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w shellapi.h.
Importowanie biblioteki:Należy użyć shell32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Omówienie ikon, ikona funkcji, ExtractIcon

Index