Función CryptSetProviderExA (wincrypt.h)

  • Artículo
Importante Esta API está en desuso. El software nuevo y existente debe empezar a usar las API cryptography Next Generation. Microsoft puede quitar esta API en futuras versiones.
 
La función CryptSetProviderEx especifica el proveedor de servicios criptográficos (CSP) predeterminado de un tipo de proveedor especificado para el equipo local o el usuario actual.
Nota Las aplicaciones típicas no usan esta función. Está pensado únicamente para su uso por parte de las 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 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 se establezca el CSP predeterminado del equipo del tipo especificado.

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. Entre los posibles códigos de error se 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.

Comentarios

La mayoría de las aplicaciones no especifican un nombre 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 determinan el CSP de un tipo especificado usado por todas las aplicaciones desde ese momento, nunca se debe llamar a CryptSetProviderEx 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wincrypt.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

CryptAcquireContext

CryptSetProvider

Funciones del proveedor de servicios