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	Mssign32.dll