CompleteAuthToken

The CompleteAuthToken function completes an authentication token. This function is used by protocols, like 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
);

Parameters

phContext
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

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 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

InitializeSecurityContext