applyControlToken 函式 (sspi.h)

ApplyControlToken 函式提供將控件令牌套用至安全性內容的方法。透過呼叫 InitializeSecurityContext (Schannel) 函式或個別訊息安全性服務來建立安全性內容時，可以接收令牌，例如驗證或解除密封。

只有安全通道安全性支援提供者 (SSP) 才支援此函式。

核心模式不支援此函式。

此函式允許將其他或取代令牌套用至內容。

語法

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pInput
);

[in] phContext

套用令牌之內容的句柄。

如需 Schannel SSP 通知關機遠端合作物件方式的相關信息，請參閱 DecryptMessage (安全通道) 的一節。如需使用此函式的其他資訊，請參閱關閉安全通道連線。

[in] pInput

SecBufferDesc 結構的指標，其中包含要套用至內容的輸入標記之 SecBuffer 結構的指標。

如果函式成功，函式會傳回SEC_E_OK。

如果函式失敗，則會傳回非零的錯誤碼。下列錯誤碼是可以傳回的其中一個可能錯誤碼。

傳回碼	Description
SEC_E_UNSUPPORTED_FUNCTION	這個值是由安全通道核心模式傳回，表示不支援此函式。

ApplyControlToken 函式可以根據此令牌修改內容。此函式可以新增至用戶端內容的標記中，會SCHANNEL_ALERT_TOKEN 和 SCHANNEL_SESSION_TOKEN。

此函式可用來關閉現有安全通道連線下的安全性內容。如需如何執行這項操作的資訊，請參閱關閉安全通道連線。