Compartir a través de


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

Disminuye el recuento de conexiones externas seguras de un objeto.

Sintaxis

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

Parámetros

[in] extconn

Tipo de conexión externa al objeto . El único tipo de conexión externa admitido actualmente por esta interfaz es seguro, lo que significa que el objeto debe permanecer activo mientras exista esta conexión externa. Las conexiones externas seguras se representan mediante el valor EXTCONN_STRONG, que se define en la EXTCONN de enumeración.

[in] reserved

Información sobre la conexión. Ole reserva este parámetro para su uso. Su valor puede ser cero, pero no necesariamente. Por lo tanto, las implementaciones de ReleaseConnection no deben contener bloques de código cuya ejecución depende de si se devuelve un valor cero.

[in] fLastReleaseCloses

Este parámetro es TRUE si la conexión que se libera es el último bloqueo externo del objeto y, por tanto, el objeto debe cerrarse. De lo contrario, el objeto debe permanecer abierto hasta que el usuario u otro proceso cierren.

Valor devuelto

El método devuelve el recuento de conexiones. Este valor está pensado para usarse solo con fines de depuración.

Comentarios

Si fLastReleaseCloses es igual a TRUE, llamar a ReleaseConnection hace que el objeto se apague. Llamar a este método es la única manera en que un objeto DLL, que se ejecuta en el mismo espacio de proceso que la aplicación contenedora, sabrá cuándo cerrarse después de una actualización silenciosa.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado objidl.h (incluya ObjIdl.h)

Consulte también

IExternalConnection