Metodo ITsSbClientConnection::P utContext (sbtsv.h)

Articolo
08/25/2023

Può essere usato dai plug-in per archiviare informazioni di contesto specifiche per la connessione.

Sintassi

HRESULT PutContext(
  [in]            BSTR    contextId,
  [in]            VARIANT context,
  [out, optional] VARIANT *existingContext
);

Parametri

[in] contextId

Variabile BSTR che contiene l'ID contesto. È consigliabile usare identificatori univoci come ID di contesto per evitare conflitti tra plug-in. Un oggetto connessione client può essere usato da più plug-in.

[in] context

Informazioni sul contesto da archiviare.

[out, optional] existingContext

Le informazioni sul contesto esistenti per l'ID contesto fornito, se presenti, vengono restituite in questo parametro. Le informazioni esistenti vengono sovrascritte.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

I plug-in possono usare l'oggetto connessione client per archiviare le informazioni di contesto specifiche di una richiesta di connessione. In questo modo i plug-in rimangono senza stato e si basano esclusivamente sulle informazioni sullo stato archiviate dalle richieste di connessione. I plug-in che usano questo metodo possono anche registrarsi per le notifiche di richiesta di connessione. I contesti possono essere eliminati al ricevimento di notifiche di CONNECTION_REQUEST_FAILED, CONNECTION_REQUEST_TIMEDOUT o CONNECTION_REQUEST_SUCCEEDED. Queste notifiche indicano che la richiesta di connessione sta per essere eliminata.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	sbtsv.h

Vedi anche

ITsSbClientConnection

Condividi tramite