Funzione CoIsHandlerConnected (combaseapi.h)

Determina se un oggetto remoto è connesso all'oggetto in-process corrispondente.

Sintassi

BOOL CoIsHandlerConnected(
  [in] LPUNKNOWN pUnk
);

Parametri

[in] pUnk

Puntatore all'interfaccia IUnknown di controllo sull'oggetto remoto.

Valore restituito

Se l'oggetto non è remoto o se è remoto e ancora connesso, il valore restituito è TRUE; in caso contrario, è FALSE.

Commenti

La funzione CoIsHandlerConnected determina lo stato di un oggetto remoto. È possibile usarlo per determinare quando rilasciare un oggetto remoto. Specificare l'oggetto remoto assegnando alla funzione un puntatore al controllo dell'interfaccia IUnknown (parametro pUnk). Un valore TRUE restituito dalla funzione indica che l'oggetto specificato non è remoto o che è remoto ed è ancora connesso al gestore remoto. Un valore FALSE restituito dalla funzione indica che l'oggetto è remoto ma non è più connesso al gestore remoto; in questo caso, il chiamante deve rispondere rilasciando l'oggetto.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione combaseapi.h (include Objbase.h)
Libreria Ole32.lib
DLL Ole32.dll