CompleteAuthToken (Windows CE 5.0)
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.
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 Values
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
Smartphone: Smartphone 2002 and later.
OS Versions: Windows CE 2.10 and later.
Header: Security.h, Sspi.h.
Link Library: Secur32.lib.
See Also
InitializeSecurityContext | SecBufferDesc
Send Feedback on this topic to the authors