SpImportSecurityContextFn callback function (ntsecpkg.h)

Article
02/22/2024

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

SpImportSecurityContextFn Spimportsecuritycontextfn;

NTSTATUS Spimportsecuritycontextfn(
  [in]  PSecBuffer pPackedContext,
  [in]  HANDLE Token,
  [out] PLSA_SEC_HANDLE phContext
)
{...}

Parameters

[in] pPackedContext

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

[in] Token

Optional. Handle to the context token.

[out] phContext

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

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	ntsecpkg.h