Función GetCryptProvFromCert
Importante
Esta API está en desuso. Microsoft puede quitar esta API en futuras versiones.
La función GetCryptProvFromCert obtiene un identificador para un proveedor de servicios criptográficos (CSP) y una especificación de clave para un contexto de certificado . Use esta función para obtener acceso a la clave privada del emisor de certificados.
Nota
Esta función no tiene ningún archivo de encabezado asociado ni biblioteca de importación. Para llamar a esta función, debe crear un archivo de encabezado definido por el usuario y usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Mssign32.dll.
Sintaxis
BOOL WINAPI GetCryptProvFromCert(
_In_ HWND hwnd,
_In_ PCCERT_CONTEXT pCert,
_Out_ HCRYPTPROV *phCryptProv,
_Out_ DWORD *pdwKeySpec,
_In_ BOOL *pfDidCryptAcquire,
_Out_opt_ LPWSTR *ppwszTmpContainer,
_Out_opt_ LPWSTR *ppwszProviderName,
_Out_ DWORD *pdwProviderType
);
Parámetros
-
hwnd [in]
-
Identificador de la ventana que se va a usar como propietario de los cuadros de diálogo que se muestran. Este miembro no se usa actualmente y se omite. Es seguro pasar NULL para este parámetro.
-
pCert [in]
-
Puntero a una estructura de CERT_CONTEXT para el certificado.
-
phCryptProv [out]
-
Puntero a una estructura HCRYPTPROV que es un identificador del CSP.
-
pdwKeySpec [out]
-
Especificación de la clave privada que se va a recuperar. Entre los valores posibles se incluyen AT_KEYEXCHANGE o AT_SIGNATURE.
-
pfDidCryptAcquire [in]
-
Valor que especifica si la función adquirió el identificador del proveedor en función del certificado.
-
ppwszTmpContainer [out, optional]
-
Dirección de un puntero a una cadena terminada en null para el nombre del contenedor de claves temporales. La función GetCryptProvFromCert proporciona e inicializa el contenedor temporal. Al llamar a GetCryptProvFromCert, la dirección debe apuntar a un valor NULL .
-
ppwszProviderName [out, optional]
-
Dirección de un puntero a una cadena terminada en null para el nombre del proveedor. La función GetCryptProvFromCert devuelve el nombre del proveedor. Al llamar a GetCryptProvFromCert, la dirección debe apuntar a un valor NULL .
-
pdwProviderType [out]
-
Especifica el tipo de CSP. Puede ser cero o uno de los tipos de proveedor criptográfico. Si este miembro es cero, el contenedor de claves es uno de los proveedores de almacenamiento de claves CNG.
Valor devuelto
Si se ejecuta correctamente, esta función devuelve TRUE. La función GetCryptProvFromCert devuelve FALSE si se produce un error.
Comentarios
La herramienta MakeCert llama a GetCryptProvFromCert cuando se invoca mediante la opción de línea de comandos -is .
Si el parámetro pfDidCryptAcquire se establece en TRUE, la función establece los parámetros phCryptProv, pdwKeySpec y pdwProviderType en los valores del proveedor.
Cuando haya terminado de usar el CSP, descargólo llamando a la función FreeCryptProvFromCert .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Archivo DLL |
|