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
SEC_E_INVALID_HANDLE
 傳遞至函式的句柄無效。
SEC_E_INVALID_TOKEN
 傳遞至函式的令牌無效。
SEC_E_OUT_OF_SEQUENCE
 用戶端的安全性內容已找到，但訊息號碼不正確。 這個傳回值會與摘要式 SSP 搭配使用。
SEC_E_MESSAGE_ALTERED
 用戶端的安全性內容已找到，但用戶端的訊息遭到竄改。 這個傳回值會與摘要式 SSP 搭配使用。
SEC_E_INTERNAL_ERROR
 未對應至 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

另請參閱

InitializeSecurityContext (Digest)

SSPI 函式

SecBufferDesc