Método ITsSbClientConnection::P utContext (sbtsv.h)
Los complementos pueden usarse para almacenar información de contexto específica de la conexión.
Sintaxis
HRESULT PutContext(
[in] BSTR contextId,
[in] VARIANT context,
[out, optional] VARIANT *existingContext
);
Parámetros
[in] contextId
Variable BSTR que contiene el identificador de contexto. Se recomienda usar identificadores únicos como identificadores de contexto para evitar colisiones entre complementos. Más de un complemento puede usar un objeto de conexión de cliente.
[in] context
Información de contexto que se va a almacenar.
[out, optional] existingContext
La información de contexto existente para el identificador de contexto proporcionado, si existe, se devuelve en este parámetro. La información existente se sobrescribe.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Los complementos pueden usar el objeto de conexión de cliente para almacenar información de contexto específica de una solicitud de conexión. Esto permite a los complementos permanecer sin estado y confiar exclusivamente en la información de estado almacenada por solicitudes de conexión. Los complementos que usan este método también pueden registrarse para las notificaciones de solicitud de conexión. Los contextos se pueden eliminar tras recibir notificaciones de CONNECTION_REQUEST_FAILED, CONNECTION_REQUEST_TIMEDOUT o CONNECTION_REQUEST_SUCCEEDED. Estas notificaciones indican que la solicitud de conexión está a punto de eliminarse.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Windows |
| Encabezado | sbtsv.h |