Función NCryptEnumStorageProviders (ncrypt.h)

La función NCryptEnumStorageProviders obtiene los nombres de los proveedores de almacenamiento de claves registrados.

Sintaxis

SECURITY_STATUS NCryptEnumStorageProviders(
  [out] DWORD              *pdwProviderCount,
  [out] NCryptProviderName **ppProviderList,
  [in]  DWORD              dwFlags
);

Parámetros

[out] pdwProviderCount

Dirección de un DWORD para recibir el número de elementos de la matriz ppProviderList .

[out] ppProviderList

Dirección de un puntero de estructura NCryptProviderName para recibir una matriz de los nombres de proveedor de almacenamiento de claves registrados. La variable a la que apunta el parámetro pdwProviderCount recibe el número de elementos de esta matriz.

Cuando ya no se necesite esta memoria, libere este puntero a la función NCryptFreeBuffer .

[in] dwFlags

Marcas que modifican el comportamiento de la función. Puede ser cero (0) o el valor siguiente.

Valor	Significado
NCRYPT_SILENT_FLAG	Solicita que el proveedor de servicios clave (KSP) no muestre ninguna interfaz de usuario. Si el proveedor debe mostrar la interfaz de usuario para funcionar, se produce un error en la llamada y el KSP debe establecer el código de error NTE_SILENT_CONTEXT como último error.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función.

Entre los posibles códigos de retorno se incluyen, entre otros, los siguientes.

Código devuelto	Descripción
ERROR_SUCCESS	La función se realizó correctamente.
NTE_BAD_FLAGS	El parámetro dwFlags contiene un valor que no es válido.
NTE_INVALID_PARAMETER	Uno o más parámetros no son válidos.
NTE_NO_MEMORY	Error de asignación de memoria.

Comentarios

Un servicio no debe llamar a esta función desde su función StartService. Si un servicio llama a esta función desde su función StartService, se puede producir un interbloqueo y el servicio puede dejar de responder.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ncrypt.h
Library	Ncrypt.lib
Archivo DLL	Ncrypt.dll

Consulte también

NCryptFreeBuffer