SpImportSecurityContext function

The SpImportSecurityContext function imports a security context from another process.

The SpImportSecurityContext function is the dispatch function for the ImportSecurityContext function of the Security Support Provider Interface.

Syntax


NTSTATUS SpImportSecurityContext(
  _In_  PSecBuffer      pPackedContext,
  _In_  HANDLE          Token,
  _Out_ PLSA_SEC_HANDLE phContext
);

Parameters

pPackedContext [in]

Pointer to a SecBuffer structure containing a serialized security context previously generated by the SpExportSecurityContext function.

Token [in]

Optional. Handle to the context token.

phContext [out]

Pointer to an LSA_SEC_HANDLE that receives the imported context handle.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed.

Remarks

SSP/APs must implement the SpImportSecurityContext function; however, the actual name given to the implementation is up to the developer.

A pointer to the SpImportSecurityContext function is available in the SECPKG_USER_FUNCTION_TABLE structure received from the SpUserModeInitialize function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecpkg.h

See also

SECPKG_USER_FUNCTION_TABLE
SpExportSecurityContext
SpUserModeInitialize

 

 

Show: