Compartir a través de

Función EnumerateSecurityPackagesA (sspi.h)

  • Artículo

La función EnumerateSecurityPackages devuelve una matriz de estructuras SecPkgInfo que proporcionan información sobre los paquetes de seguridad de disponibles para el cliente.

Sintaxis

SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackagesA(
  [in] unsigned long *pcPackages,
  [in] PSecPkgInfoA  *ppPackageInfo
);

Parámetros

[in] pcPackages

Puntero a una variable de ULONG que recibe el número de paquetes disponibles en el sistema. Esto incluye paquetes que ya están cargados y paquetes disponibles a petición.

[in] ppPackageInfo

Puntero a una variable que recibe un puntero a una matriz de estructuras SecPkgInfo. Cada estructura contiene información del proveedor de compatibilidad de seguridad (SSP) que describe las funcionalidades del paquete de seguridad disponible en ese SSP.

Cuando haya terminado de usar la matriz, libere la memoria llamando a la función FreeContextBuffer.

Valor devuelto

Si la función se realiza correctamente, la función devuelve SEC_E_OK.

Si se produce un error en la función, devuelve un código de error distinto de cero. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente.

Código y valor devueltos Descripción
SEC_E_INSUFFICIENT_MEMORY
0x80090300L
 No había suficiente memoria para asignar uno o varios de los búferes.
SEC_E_INVALID_HANDLE
0x80090301L
 Se especificó un identificador no válido.
SEC_E_SECPKG_NOT_FOUND
0x80090305L
 No se encontró el paquete especificado.

Observaciones

El autor de la llamada puede usar el miembro Name de una estructura de SecPkgInfo para especificar un paquete de seguridad en una llamada a la función AcquireCredentialsHandle (General).

Nota

El encabezado sspi.h define EnumerateSecurityPackages como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de sspi.h (include Security.h)
biblioteca de Secur32.lib
DLL de SspiCli.dll

Consulte también

AcquireCredentialsHandle (General)

FreeContextBuffer

funciones SSPI de

SecPkgInfo