Método IExternalConnection::ReleaseConnection (objidlbase.h)

  • Artigo

Diminui a contagem de conexões externas fortes de um objeto.

Sintaxe

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

Parâmetros

[in] extconn

O tipo de conexão externa com o objeto . O único tipo de conexão externa atualmente compatível com essa interface é forte, o que significa que o objeto deve permanecer ativo enquanto essa conexão externa existir. Conexões externas fortes são representadas pelo valor EXTCONN_STRONG, que é definido na enumeração EXTCONN.

[in] reserved

Informações sobre a conexão. Esse parâmetro é reservado para uso pelo OLE. Seu valor pode ser zero, mas não necessariamente. Portanto, as implementações de ReleaseConnection não devem conter blocos de código cuja execução depende se um valor zero é retornado.

[in] fLastReleaseCloses

Esse parâmetro será TRUE se a conexão que está sendo liberada for o último bloqueio externo no objeto e, portanto, o objeto deverá ser fechado. Caso contrário, o objeto deve permanecer aberto até ser fechado pelo usuário ou outro processo.

Retornar valor

O método retorna a contagem de conexões. Esse valor destina-se a ser usado apenas para fins de depuração.

Comentários

Se fLastReleaseCloses for igual a TRUE, chamar ReleaseConnection fará com que o objeto se desligue. Chamar esse método é a única maneira pela qual um objeto DLL, em execução no mesmo espaço de processo que o aplicativo de contêiner, saberá quando fechar após uma atualização silenciosa.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidlbase.h (inclua ObjIdl.h)

Confira também

Iexternalconnection