CreatePointerMoniker-Funktion (objbase.h)
Erstellt einen Zeigermoniker basierend auf einem Zeiger auf ein Objekt.
Syntax
HRESULT CreatePointerMoniker(
[in, optional] LPUNKNOWN punk,
[out] LPMONIKER *ppmk
);
Parameter
[in, optional] punk
Ein Zeiger auf eine IUnknown-Schnittstelle für das Objekt, das durch den resultierenden Moniker identifiziert werden soll.
[out] ppmk
Die Adresse einer IMoniker*-Zeigervariable, die den Schnittstellenzeiger auf den neuen Zeigermoniker empfängt. Bei erfolgreicher Ausführung hat die Funktion AddRef für den Moniker aufgerufen, und der Aufrufer ist für den Aufruf von Release verantwortlich. Wenn ein Fehler auftritt, weist der zurückgegebene Schnittstellenzeiger einen NULL-Wert auf.
Rückgabewert
Diese Funktion kann die Standardrückgabewerte E_OUTOFMEMORY, E_UNEXPECTED und S_OK zurückgeben.
Hinweise
Ein Zeigermoniker umschließt einen vorhandenen Schnittstellenzeiger in einen Moniker, der an die Schnittstellen übergeben werden kann, die Moniker erfordern. Zeigermoniker ermöglichen es einem Objekt, das keine persistente Darstellung hat, an einem Moniker-Bindungsvorgang teilzunehmen.
Zeigermoniker werden häufig nicht verwendet, sodass diese Funktion nicht häufig aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objbase.h |
| Bibliothek | Ole32.lib |
| DLL | Ole32.dll |
| APIs | ext-ms-win-com-ole32-l1-1-0 (eingeführt in Windows 8) |