Metodo IExternalConnection::ReleaseConnection (objidlbase.h)

Articolo
03/15/2023

Decrementa il conteggio delle connessioni esterne forti 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 fino a quando esiste questa connessione esterna. 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 OLE. Il suo valore può essere zero, ma non necessariamente. Pertanto, le implementazioni di ReleaseConnection non devono contenere blocchi di codice il cui esecuzione dipende dal fatto che venga restituito un valore zero.

[in] fLastReleaseCloses

Questo parametro è TRUE se la connessione rilasciata è l'ultimo blocco esterno dell'oggetto e pertanto l'oggetto deve chiudere. 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 numero di connessioni. Questo valore deve essere usato solo per scopi 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	objidlbase.h (include ObjIdl.h)

Vedi anche

IExternalConnection

Condividi tramite