OleGetIconOfFile-Funktion (ole2.h)

Gibt ein Handle für eine Metadatei zurück, die ein Symbol und eine Zeichenfolgenbezeichnung für den angegebenen Dateinamen enthält.

Syntax

HGLOBAL OleGetIconOfFile(
  [in] LPOLESTR lpszPath,
  [in] BOOL     fUseFileAsLabel
);

Parameter

[in] lpszPath

Ein Zeiger auf eine Datei, für die das Symbol und die Zeichenfolge angefordert werden sollen.

[in] fUseFileAsLabel

Gibt an, ob der Dateiname als Symbolbezeichnung verwendet werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine Metadatei, die ein Symbol und eine Bezeichnung für die angegebene Datei enthält. Wenn in der Registrierungsdatenbank für die Datei keine CLSID vorhanden ist, gibt die Funktion die Zeichenfolge "Document" zurück. Wenn lpszPathNULL ist, gibt die Funktion NULL zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ole2.h
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen

OleGetIconOfClass

OleMetafilePictFromIconAndLabel