CompleteAuthToken (Compact 2013)

  • Article

3/28/2014

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

See Also

Reference

Authentication Services Functions
InitializeSecurityContext
SecBufferDesc