OleMetafilePictFromIconAndLabel-Funktion (ole2.h)

Erstellt eine Metadatei, in der das angegebene Symbol und die bezeichnung gezeichnet werden.

Syntax

HGLOBAL OleMetafilePictFromIconAndLabel(
  [in] HICON    hIcon,
  [in] LPOLESTR lpszLabel,
  [in] LPOLESTR lpszSourceFile,
  [in] UINT     iIconIndex
);

Parameter

[in] hIcon

Handle für das Symbol, das in die Metadatei gezeichnet werden soll. Dieser Parameter kann NULL sein. Wenn hIconNULL ist, gibt diese Funktion NULL zurück, ohne eine Metadatei zu erstellen.

[in] lpszLabel

Die Symbolbezeichnung. Dieser Parameter kann NULL sein. Wenn lpszLabelNULL ist, enthält die resultierende Metadatei keine Bezeichnung.

[in] lpszSourceFile

Der Pfad und Dateiname der Symboldatei. Diese Zeichenfolge kann über die Benutzeroberfläche oder aus der Registrierungsdatenbank abgerufen werden. Dieser Parameter kann NULL sein.

[in] iIconIndex

Der Speicherort des Symbols in der Datei mit dem Namen lpszSourceFile, ausgedrückt als Offset in Bytes vom Anfang der Datei.

Rückgabewert

Ein globales Handle für eine METAFILEPICT-Struktur , die das Symbol und die Bezeichnung enthält. Die Metadatei verwendet den MM_ANISOTROPIC-Zuordnungsmodus.

Wenn ein Fehler auftritt, ist das zurückgegebene Handle NULL. In diesem Fall kann der Aufrufer GetLastError aufrufen, um weitere Informationen zu erhalten.

Hinweise

Diese Funktion wird von OleGetIconOfFile und OleGetIconOfClass aufgerufen.

Wenn lpszSourceFile nicht NULL und iIconIndex nicht 0 ist, werden der Name der in lpszSourceFile übergebenen Quelldatei und der von iIconIndex übergebene Index der erstellten Metadatei als Kommentardatensatz hinzugefügt.

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

OleGetIconOfFile