IGlobalInterfaceTable::RegisterInterfaceInGlobal-Methode (objidl.h)

  • Artikel

Registriert die angegebene Schnittstelle für ein Objekt, das sich in einer Wohnung eines Prozesses befindet, als globale Schnittstelle, sodass anderen Wohnungen der Zugriff auf diese Schnittstelle ermöglicht wird.

Syntax

HRESULT RegisterInterfaceInGlobal(
  [in]  IUnknown *pUnk,
  [in]  REFIID   riid,
  [out] DWORD    *pdwCookie
);

Parameter

[in] pUnk

Ein Schnittstellenzeiger vom Typ riid für das Objekt, für das die als global zu registrierende Schnittstelle implementiert ist.

[in] riid

Die IID der Schnittstelle, die als global registriert werden soll.

[out] pdwCookie

Ein Bezeichner, der von einem anderen Apartment verwendet werden kann, um Zugriff auf einen Zeiger auf die zu registrierende Schnittstelle zu erhalten. Der Wert eines ungültigen Cookies ist 0.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG
 Mindestens ein Parameter ist ungültig.

Hinweise

Wird in der Wohnung aufgerufen, in der sich ein Objekt befindet, um eine der Schnittstellen des Objekts als globale Schnittstelle zu registrieren. Diese Methode stellt einen Zeiger auf ein Cookie bereit, den andere Wohnungen in einem Aufruf der GetInterfaceFromGlobal-Methode verwenden können, um einen Zeiger auf diese Schnittstelle abzurufen.

Der Schnittstellenzeiger kann ein Zeiger auf ein In-Process-Objekt oder ein Zeiger auf einen Proxy für ein Objekt sein, das sich in einer anderen Wohnung, in einem anderen Prozess oder auf einem anderen Computer befindet.

Das Apartment, das diese Methode aufruft, muss bis zum entsprechenden Aufruf von RevokeInterfaceFromGlobal am Leben bleiben.

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 objidl.h (include ObjIdl.h)

Weitere Informationen

IGlobalInterfaceTable