Función CryptSetProviderExA (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 CryptSetProviderEx especifica el proveedor de servicios criptográficos predeterminado (CSP) de un tipo de proveedor especificado para el equipo local o el usuario actual.

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

 

Sintaxis

BOOL CryptSetProviderExA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType,
  [in] DWORD  *pdwReserved,
  [in] DWORD  dwFlags
);

Parámetros

[in] pszProvName

Nombre del nuevo CSP predeterminado. Debe ser un CSP instalado 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.

[in] pdwReserved

Este parámetro está reservado para uso futuro y debe ser NULL.

[in] dwFlags

Se definen los siguientes valores de marca.

Valor	Significado
CRYPT_DELETE_DEFAULT 0x00000004	Se puede usar junto con CRYPT_MACHINE_DEFAULT o CRYPT_USER_DEFAULT para eliminar el valor predeterminado.
CRYPT_USER_DEFAULT 0x00000002	Hace que se establezca el CSP predeterminado de contexto de usuario del tipo especificado.
CRYPT_MACHINE_DEFAULT 0x00000001	Hace que el CSP predeterminado del equipo del tipo especificado se establezca.

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. Los códigos de error posibles incluyen los que se muestran en la tabla siguiente.

Código devuelto	Descripción
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.

Observaciones

La mayoría de las aplicaciones no especifican un nombre de CSP al llamar a la función CryptAcquireContext; Sin embargo, una aplicación puede especificar un nombre de CSP y, por tanto, seleccionar un CSP con un nivel de seguridad adecuado. Dado que las llamadas a CryptSetProviderEx determinar el CSP de un tipo especificado usado por todas las aplicaciones desde ese punto, CryptSetProviderEx nunca se debe llamar sin el consentimiento de un usuario.

Nota

El encabezado wincrypt.h define CryptSetProviderEx 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

CryptSetProvider

funciones del proveedor de servicios de