IOleObject::GetMoniker-Methode (oleidl.h)

Artikel
03/01/2024

Ruft den Moniker eines eingebetteten Objekts ab, den der Aufrufer verwenden kann, um eine Verknüpfung mit dem Objekt zu erstellen.

Syntax

HRESULT GetMoniker(
  [in]  DWORD    dwAssign,
  [in]  DWORD    dwWhichMoniker,
  [out] IMoniker **ppmk
);

Parameter

[in] dwAssign

Bestimmt, wie der Moniker dem Objekt zugewiesen wird. Abhängig vom Wert von dwAssign führt IOleObject::GetMoniker eine der folgenden Aktionen aus:

Ruft einen Moniker nur ab, wenn einer bereits zugewiesen wurde.
Erzwingt bei Bedarf die Zuweisung eines Monikers, um den Aufruf zu erfüllen.
Ruft einen temporären Moniker ab.

Werte für dwAssign werden in der Enumeration OLEGETMONIKER angegeben.

Hinweis Sie können OLEGETMONIKER_UNASSIGN nicht übergeben, wenn Sie IOleObject::GetMoniker aufrufen. Dieser Wert ist nur gültig, wenn IOleObject::GetMoniker aufgerufen wird.

[in] dwWhichMoniker

Gibt die Form des angeforderten Monikers an. Mögliche Werte werden der Enumeration OLEWHICHMK entnommen.

[out] ppmk

Adresse der IMoniker-Zeigervariable , die den Schnittstellenzeiger auf den Moniker des Objekts empfängt. Wenn ein Fehler auftritt, muss ppmk auf NULL festgelegt werden. Jedes Mal, wenn ein Objekt einen Aufruf von IOleObject::GetMoniker empfängt, muss die Verweisanzahl für ppmk erhöht werden. Es liegt in der Verantwortung des Aufrufers, Release aufzurufen, wenn dies mit ppmk erfolgt.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Hinweise

Die IOleObject::GetMoniker-Methode gibt den Moniker eines Objekts zurück. Wie IOleObject::SetMoniker ist diese Methode nur im Kontext der Verwaltung von Links zu eingebetteten Objekten wichtig und auch in diesem Fall optional. Ein potenzieller Linkclient, der den Moniker eines Objekts benötigt, um an das Objekt zu binden, kann diese Methode aufrufen, um diesen Moniker abzurufen. Die Standardimplementierung von IOleObject::GetMoniker ruft IOleClientSite::GetMoniker auf und gibt E_UNEXPECTED zurück, wenn das Objekt nicht ausgeführt wird oder keinen gültigen Zeiger auf einen Clientstandort aufweist.

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	oleidl.h