CompleteAuthToken
A version of this page is also available for
4/8/2010
This function completes an authentication token. This function is used by protocols, such as the distributed computing environment (DCE), that need to revise the security information after the transport application has updated some message parameters.
Syntax
SECURITY_STATUS SEC_ENTRY CompleteAuthToken(
PCtxtHandle phContext,
PSecBufferDesc pToken
);
Parameters
- phContext
[in] Pointer to a CtxtHandle structure identifying the context handle. For information on CtxtHandle, see SSPI Handles.
- pToken
[in] Pointer to a SecBufferDesc structure that contains the buffer descriptor for the entire message.
Return Value
Returns SEC_E_OK to indicate success. The following table shows the possible error values.
| Value | Description |
|---|---|
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 |
The Local Security Authority cannot be contacted. |
Remarks
The client of a transport application calls this 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 should call this function only if the InitializeSecurityContext call returned SEC_I_COMPLETE_NEEDED or SEC_I_COMPLETE_AND_CONTINUE.
Requirements
| Header | security.h, sspi.h |
| Library | secur32.lib |
| Windows Embedded CE | Windows CE 2.10 and later |
| Windows Mobile | Smartphone 2002 and later |