Función PvkGetCryptProv

Importante

Esta API está en desuso. Microsoft puede quitar esta API en futuras versiones.

 

La función PvkGetCryptProv obtiene un identificador para un proveedor de servicios criptográficos (CSP) basado en un archivo de clave privada o en un nombre de contenedor de claves.

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

HRESULT WINAPI PvkGetCryptProv(
  _In_      HWND       hwnd,
  _In_      LPCWSTR    pwszCaption,
  _In_      LPCWSTR    pwszCapiProvider,
  _In_      DWORD      dwProviderType,
  _In_      LPCWSTR    pwszPvkFile,
  _In_      LPCWSTR    pwszKeyContainerName,
  _Out_     DWORD      *pdwKeySpec,
  _Out_opt_ LPWSTR     *ppwszTmpContainer,
  _Out_     HCRYPTPROV *phCryptProv
);

Parámetros

hwnd [in]

Si se requiere una contraseña para descifrar el archivo de clave privada, este parámetro es un identificador para el elemento primario del cuadro de diálogo de contraseña; de lo contrario, es NULL.

pwszCaption [in]

Puntero a una cadena terminada en null para el cuadro de diálogo subtítulo.

pwszCapiProvider [in]

Puntero a una cadena terminada en null para el nombre de CSP.

dwProviderType [in]

Valor DWORD que representa el tipo de proveedor criptográfico. Para obtener más información, vea Tipos de proveedor criptográfico.

pwszPvkFile [in]

Puntero a una cadena terminada en null que contiene el nombre de un archivo de clave privada.

pwszKeyContainerName [in]

Puntero a una cadena terminada en null para el nombre del contenedor de claves privadas.

pdwKeySpec [out]

Puntero a un valor DWORD para el tipo de clave del contenedor devuelto con phCryptProv y ppwszTmpContainer.

ppwszTmpContainer [out, optional]

Dirección de un puntero a una cadena terminada en null para el nombre del contenedor de claves temporal. La función PvkGetCryptProv proporciona e inicializa el contenedor temporal. Al llamar a PvkGetCryptProv, la dirección debe apuntar a un valor NULL .

phCryptProv [out]

Puntero a un identificador para el CSP.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

La función PvkGetCryptProv primero intenta obtener el identificador del proveedor del nombre del contenedor de claves especificado por el parámetro pwszKeyContainerName . Si pasa NULL para el parámetro pwszKeyContainerName , PvkGetCryptProv intenta obtener el proveedor del archivo de clave privada especificado en el parámetro pwszPvkFile .

Cuando haya terminado de usar el CSP, libere el identificador del proveedor y el contenedor de claves temporales mediante una llamada a la función PvkFreeCryptProv .

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