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 |