Función CryptSetProviderA (wincrypt.h)

importante Esta API está en desuso. El software nuevo y existente debe empezar a usar las API de Cryptography Next Generation. Microsoft puede quitar esta API en futuras versiones.

 

La función CryptSetProvider especifica el proveedor de servicios criptográficos (CSP) predeterminado del usuario actual.

Si se establece el proveedor predeterminado de un usuario actual, ese proveedor predeterminado lo adquiere cualquier llamada de ese usuario para CryptAcquireContext especificar un tipo de proveedor dwProvType pero no un nombre de CSP.

También hay disponible una versión mejorada de esta función, CryptSetProviderEx.

Nota Aplicaciones típicas no usan esta función. Está pensado para su uso únicamente mediante aplicaciones administrativas.

 

Sintaxis

BOOL CryptSetProviderA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType
);

Parámetros

[in] pszProvName

Nombre del nuevo CSP predeterminado. El CSP con nombre debe instalarse en el equipo. Para obtener una lista de los proveedores criptográficos disponibles, consulte Nombres de proveedor criptográfico.

[in] dwProvType

Tipo de proveedor del CSP especificado por pszProvName.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero (TRUE).

Si se produce un error en la función, el valor devuelto es cero (FALSE). Para obtener información de error extendida, llame a GetLastError. En la tabla siguiente se enumeran algunos códigos de error posibles.

Código devuelto	Descripción
ERROR_INVALID_HANDLE	Uno de los parámetros especifica un identificador que no es válido.
ERROR_INVALID_PARAMETER	Uno de los parámetros contiene un valor que no es válido. Suele ser un puntero que no es válido.
ERROR_NOT_ENOUGH_MEMORY	El sistema operativo se quedó sin memoria durante la operación.

 

Los errores también se pueden propagar desde llamadas internas a regCreateKeyEx y RegSetValueEx.

Observaciones

Las aplicaciones típicas no especifican un nombre csp al llamar a CryptAcquireContext; sin embargo, una aplicación tiene la opción de seleccionar un CSP específico. Esto proporciona a un usuario la libertad de seleccionar un CSP con un nivel de seguridad adecuado.

Dado que llamar a CryptSetProvider determina el CSP de un tipo especificado usado por todas las aplicaciones que se ejecutan desde ese punto, esta función no debe llamarse sin el consentimiento de los usuarios.

Nota

El encabezado wincrypt.h define CryptSetProvider 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	wincrypt.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll

Consulte también

CryptAcquireContext

nombres de proveedor criptográfico

RegCreateKeyEx

RegSetValueEx

funciones del proveedor de servicios de