共用方式為

ITsSbClientConnection：:P utContext 方法 (sbtsv.h)

  • 發行項

外掛程式可用來儲存連線特定的內容資訊。

語法

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

參數

[in] contextId

包含內容識別碼的 BSTR 變數。 我們建議使用唯一標識碼作為內容標識符，以避免外掛程式之間的衝突。用戶端連接物件可以由多個外掛程式使用。

[in] context

要儲存的內容資訊。

[out, optional] existingContext

如果有任何內容識別碼，則會在此參數中傳回提供之內容標識碼的現有內容資訊。 覆寫現有的資訊。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

外掛程式可以使用用戶端連接對象來儲存連線要求特有的內容資訊。 這可讓外掛程式保持無狀態，並依賴連線要求所儲存的狀態資訊。 使用此方法的外掛程式也可以註冊連線要求通知。 在收到CONNECTION_REQUEST_FAILED、CONNECTION_REQUEST_TIMEDOUT或CONNECTION_REQUEST_SUCCEEDED通知時，可以刪除內容。 這些通知表示即將刪除連線要求。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2012
目標平台 Windows
標頭 sbtsv.h

另請參閱

ITsSbClientConnection