SpGetExtendedInformationFn callback function (ntsecpkg.h)

The SpGetExtendedInformation function provides extended information about a security package.

Syntax

SpGetExtendedInformationFn Spgetextendedinformationfn;

NTSTATUS Spgetextendedinformationfn(
  [in]  SECPKG_EXTENDED_INFORMATION_CLASS Class,
  [out] PSECPKG_EXTENDED_INFORMATION *ppInformation
)
{...}

Parameters

[in] Class

A value from the SECPKG_EXTENDED_INFORMATION_CLASS enumeration indicating the type of extended information.

[out] ppInformation

Pointer to a pointer to a SECPKG_EXTENDED_INFORMATION structure allocated by the security package. If the function call succeeds, the returned structure contains the requested information.

Return value

If the function succeeds, return STATUS_SUCCESS.

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

Remarks

Extended information is set using the SpSetExtendedInformation function.

An SSP/AP must implement the SpGetExtendedInformation function; however, the actual name given to the implementation is up to the package developer.

A pointer to the SpGetExtendedInformation function is available in the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize 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

See also

SECPKG_EXTENDED_INFORMATION

SECPKG_EXTENDED_INFORMATION_CLASS

SECPKG_FUNCTION_TABLE

SecPkgInfo

SpLsaModeInitialize

SpSetExtendedInformation