CompleteAuthToken
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.
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.
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.10 and later | Sspi.h | Security.h | Schannel.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
InitializeSecurityContext, SecBufferDesc
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.