Metodo IExternalConnection::ReleaseConnection (objidl.h)

Articolo
08/25/2023

Decrementa il conteggio delle connessioni esterne complesse di un oggetto.

Sintassi

DWORD ReleaseConnection(
  [in] DWORD extconn,
  [in] DWORD reserved,
  [in] BOOL  fLastReleaseCloses
);

Parametri

[in] extconn

Tipo di connessione esterna all'oggetto . L'unico tipo di connessione esterna attualmente supportato da questa interfaccia è sicuro, il che significa che l'oggetto deve rimanere attivo finché questa connessione esterna esiste. Le connessioni esterne complesse sono rappresentate dal valore EXTCONN_STRONG, definito nell'enumerazione EXTCONN.

[in] reserved

Informazioni sulla connessione. Questo parametro è riservato per l'uso da PARTE di OLE. Il valore può essere zero, ma non necessariamente. Di conseguenza, le implementazioni di ReleaseConnection non devono contenere blocchi di codice la cui esecuzione dipende dal fatto che venga restituito un valore zero.

[in] fLastReleaseCloses

Questo parametro è TRUE se la connessione rilasciata è l'ultimo blocco esterno sull'oggetto e pertanto l'oggetto deve chiudersi. In caso contrario, l'oggetto deve rimanere aperto fino a quando non viene chiuso dall'utente o da un altro processo.

Valore restituito

Il metodo restituisce il conteggio delle connessioni. Questo valore deve essere usato solo a scopo di debug.

Commenti

Se fLastReleaseCloses è uguale a TRUE, la chiamata a ReleaseConnection causa l'arresto dell'oggetto stesso. La chiamata a questo metodo è l'unico modo in cui un oggetto DLL, in esecuzione nello stesso spazio di processo dell'applicazione contenitore, saprà quando chiudere dopo un aggiornamento invisibile all'utente.

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

Vedi anche

IExternalConnection

Condividi tramite