SpQueryCredentialsAttributesFn callback function (ntsecpkg.h)

The SpQueryCredentialsAttributes function retrieves the attributes for a credential.

The SpQueryCredentialsAttributes function is the dispatch function for the QueryCredentialsAttributes function of the Security Support Provider Interface.

Syntax

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

Parameters

[in] CredentialHandle

A handle to the credential to query.

[in] CredentialAttribute

Attribute to query. The following table lists the valid values.

[out] Buffer

Pointer to a buffer that receives the requested attributes. Allocate memory for this buffer using the AllocateClientBuffer function, so that caller can free it by calling the FreeContextBuffer 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 common reasons for failure and the error codes that the function should return.

Remarks

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

A pointer to the SpQueryCredentialsAttributes function is available in the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize function.

Requirements

See also

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize