IGlobalInterfaceTable::RegisterInterfaceInGlobal-Methode (objidl.h)
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 |
---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
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) |