EnumerateSecurityPackages function
Applies to: desktop apps only
The EnumerateSecurityPackages function returns an array of SecPkgInfo structures that provide information about the security packages available to the client.
Syntax
SECURITY_STATUS SEC_Entry EnumerateSecurityPackages( __in PULONG pcPackages, __in PSecPkgInfo *ppPackageInfo );
Parameters
- pcPackages [in]
-
A pointer to a ULONG variable that receives the number of packages available on the system. This includes packages that are already loaded and packages available on demand.
- ppPackageInfo [in]
-
A pointer to a variable that receives a pointer to an array of SecPkgInfo structures. Each structure contains information from the security support provider (SSP) that describes the capabilities of the security package available within that SSP.
When you have finished using the array, free the memory by calling the FreeContextBuffer function.
Return value
If the function succeeds, the function returns SEC_E_OK.
If the function fails, it returns a nonzero error code. Possible values include, but are not limited to, those in the following table.
| Return code/value | Description |
|---|---|
|
There was not sufficient memory to allocate one or more of the buffers. |
|
An invalid handle was specified. |
|
The specified package was not found. |
Remarks
The caller can use the Name member of a SecPkgInfo structure to specify a security package in a call to the AcquireCredentialsHandle (General) function.
Requirements
|
Minimum supported client | Windows 2000 Professional |
|---|---|
|
Minimum supported server | Windows 2000 Server |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names | EnumerateSecurityPackagesW (Unicode) and EnumerateSecurityPackagesA (ANSI) |
See also
Send comments about this topic to Microsoft
Build date: 3/13/2012
