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)

Weitere Informationen

Imoniker