Platform SDK: Logon Authentication |
The CompleteAuthToken function completes an authentication token. This function is used by protocols such as DCE that need to revise the security information after the transport application has updated some message parameters.
SECURITY_STATUS CompleteAuthToken( PCtxtHandle phContext, // handle of the context to complete PSecBufferDesc pToken // token to complete );
If the function succeeds, the return value is SEC_E_OK.
If the function fails, the return value can be one of the following error codes.
Value | Meaning |
---|---|
SEC_E_INVALID_HANDLE | The handle passed to the function is invalid. |
SEC_E_INVALID_TOKEN | The token passed to the function is invalid. |
SEC_E_INTERNAL_ERROR | An unidentified internal error has occurred. |
The client of a transport application calls the CompleteAuthToken function to allow the security package to update a checksum or similar operation after all the protocol headers have been updated by the transport application. The client calls this function only if the InitializeSecurityContext call returned SEC_I_COMPLETE_NEEDED or SEC_I_COMPLETE_AND_CONTINUE.
The prototype for this function can be found in Sspi.h.
Windows NT/2000: Requires Windows NT 3.51 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in Sspi.h; include Security.h.
Library: Use Secur32.lib.