EnumerateSecurityPackages
A version of this page is also available for
4/8/2010
This function retrieves an array of SecPkgInfo structures that describe the security packages available to the client.
Syntax
SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackages(
ULONG SEC_FAR* pcPackages,
PSecPkgInfo SEC_FAR* ppPackageInfo
);
Parameters
- pcPackages
[out] Pointer to the number of packages.
- ppPackageInfo
[out] Pointer to an array of SecPkgInfo structures. Each structure contains data that describes a security package available from the security provider.
Return Value
Returns SEC_E_OK to indicate 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 indicated by ppPackageInfo.
Requirements
| Header | security.h, sspi.h |
| Library | secur32.lib |
| Windows Embedded CE | Windows CE 2.10 and later |
| Windows Mobile | Smartphone 2002 and later |