Export (0) Print
Expand All
Expand Minimize

SpQueryContextAttributes function

The SpQueryContextAttributes function retrieves the attributes of a security context.

The SpQueryContextAttributes function is the dispatch function for the QueryContextAttributes (General) function of the Security Support Provider Interface.

Syntax


NTSTATUS SpQueryContextAttributes(
  _In_   LSA_SEC_HANDLE ContextHandle,
  _In_   ULONG ContextAttribute,
  _Out_  PVOID Buffer
);

Parameters

ContextHandle [in]

A handle to the security context.

ContextAttribute [in]

Context attribute to query. For a list of valid values, see the QueryContextAttributes (General) function.

Buffer [out]

Pointer that receives the address of a buffer containing the requested attributes. Memory for the Buffer parameter should be allocated with the AllocateHeap function from the SECPKG_DLL_FUNCTIONS function table in user-mode. In Local Security Authority (LSA) mode, use the AllocateLsaHeap function.

Return value

If the function succeeds, return STATUS_SUCCESS.

If the function fails, return an NTSTATUS code that indicates the reason it failed. The following lists a common reason for failure and the error code that the function should return.

Return codeDescription
SEC_E_INVALID_HANDLE

The handle is not valid.

 

Remarks

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

A pointer to the LSA-mode implementation of the SpQueryContextAttributes function is available in the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize function.

A pointer to the user-mode implementation of the SpQueryContextAttributes 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_FUNCTION_TABLE
SpLsaModeInitialize

 

 

Community Additions

ADD
Show:
© 2015 Microsoft