This function completes an authentication token. This function is used by protocols, like the Distributed Computing Environment (DCE), that need to revise the security information after the transport application has updated some message parameters.
At a Glance
| Header file: | Sspi.h |
| Windows CE versions: | 2.10 and later |
Syntax
SECURITY_STATUS CompleteAuthToken( PCtxtHandle phContext,
PSecBufferDesc pToken);
Parameters
phContext
Pointer to the handle of the context that needs to be completed.
pToken
Pointer to a SecBufferDesc structure that contains the buffer descriptor for the entire message.
Return Values
SEC_E_OK indicates success.
Upon failure, one of the error values described in the following table is returned.
| Value | Description |
| SEC_E_INVALID_HANDLE | The handle passed to the function is invalid. |
| SEC_E_INVALID_TOKEN | The token pased to the function is invalid. |
| SEC_E_INTERNAL_ERROR |
Remarks
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 should call this function only if the InitializeSecurityContext call returned SEC_I_COMPLETE_NEEDED or SEC_I_COMPLETE_AND_CONTINUE.
See Also