EnumerateSecurityPackages

This function returns an array of SecPkgInfo structures that describe the security packages available to the client.

At a Glance

Header file:	Sspi.h
Windows CE versions:	2.10 and later

Syntax

SECURITY_STATUS EnumerateSecurityPackages( PULONG pcPackages, PSecPkgInfo *ppPackageInfo );

Parameters

pcPackages

[out] Pointer to a ULONG variable that receives the number of packages returned

ppPackageInfo

[out] Pointer to a variable that receives a pointer to an array of SecPkgInfo structures. Each structure contains data that describes a security package available from the security provider.

Return Values

SEC_E_OK indicates success. A nonzero error value indicates failure.

Remarks

The SecPkgInfo structures provide data that the caller can use to determine which security package best satisfies the caller’s requirements.

The caller can use the Name member of a SecPkgInfo structure to specify a security package in a call to the AcquireCredentialsHandle function.

The caller must assume that the security provider includes all available security packages in the single call to EnumerateSecurityPackages.

The caller must call the FreeContextBuffer function to free the buffer returned in ppPackageInfo.