CoIsHandlerConnected-Funktion (combaseapi.h)

Bestimmt, ob ein Remoteobjekt mit dem entsprechenden prozessinternen Objekt verbunden ist.

Syntax

BOOL CoIsHandlerConnected(
  [in] LPUNKNOWN pUnk
);

Parameter

[in] pUnk

Ein Zeiger auf die steuernde IUnknown-Schnittstelle im Remoteobjekt.

Rückgabewert

Wenn das Objekt nicht remote ist oder es remote ist und weiterhin verbunden ist, ist der Rückgabewert TRUE; Andernfalls ist es FALSE.

Hinweise

Die CoIsHandlerConnected-Funktion bestimmt die status eines Remoteobjekts. Sie können damit bestimmen, wann ein Remoteobjekt freigegeben werden soll. Sie geben das Remoteobjekt an, indem Sie der Funktion einen Zeiger auf die steuernde IUnknown-Schnittstelle (den pUnk-Parameter ) geben. Der von der Funktion zurückgegebene Wert TRUE gibt entweder an, dass das angegebene Objekt nicht remote ist, oder dass es remote ist und weiterhin mit dem Remotehandler verbunden ist. Der wert FALSE , der von der Funktion zurückgegeben wird, gibt an, dass das Objekt remote ist, aber nicht mehr mit seinem Remotehandler verbunden ist. In diesem Fall sollte der Aufrufer reagieren, indem er das -Objekt freigibt.

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	combaseapi.h (include Objbase.h)
Bibliothek	Ole32.lib
DLL	Ole32.dll