Compartir a través de

Método ITsSbClientConnection::P utContext (sbtsv.h)

  • Artículo

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

Consulte también

ITsSbClientConnection