completeAuthToken 函式 (sspi.h)
CompleteAuthToken 函式會完成驗證令牌。 傳輸應用程式更新一些訊息參數之後,需要修改安全性資訊的通訊協定,例如 DCE 使用此函式。
只有摘要 式安全性支援提供者 (SSP) 才支援此函式。
CompleteAuthToken 只會在伺服器端使用。
SECURITY_STATUS SEC_ENTRY CompleteAuthToken(
[in] PCtxtHandle phContext,
[in] PSecBufferDesc pToken
);
[in] phContext
需要完成之內容的句柄。
[in] pToken
SecBufferDesc 結構的指標,其中包含整個訊息的緩衝區描述元。
如果函式成功,函式會傳回SEC_E_OK。
如果函式失敗,它會傳回下列其中一個錯誤碼。
傳回碼 | Description |
---|---|
|
傳遞至函式的句柄無效。 |
|
傳遞至函式的令牌無效。 |
|
用戶端的安全性內容已找到,但訊息號碼不正確。 這個傳回值會與摘要式 SSP 搭配使用。 |
|
用戶端的安全性內容已找到,但用戶端的訊息遭到竄改。 這個傳回值會與摘要式 SSP 搭配使用。 |
|
未對應至 SSPI 錯誤碼的錯誤。 |
傳輸應用程式的用戶端會呼叫 CompleteAuthToken 函式,以允許 安全性套件 在傳輸應用程式更新所有通訊協定標頭之後更新總和檢查碼或類似作業。 只有當 InitializeSecurityContext (Digest) 呼叫傳回SEC_I_COMPLETE_NEEDED或SEC_I_COMPLETE_AND_CONTINUE時,用戶端才會呼叫此函式。
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | sspi.h (包含 Security.h) |
程式庫 | Secur32.lib |
Dll | Secur32.dll |