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 |