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) |