Función PvkPrivateKeyAcquireContextFromMemory

  • Artículo

Importante

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

 

La función PvkPrivateKeyAcquireContextFromMemory crea un contenedor temporal en el proveedor de servicios criptográficos (CSP) y carga una clave privada de la memoria en el contenedor.

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 PvkPrivateKeyAcquireContextFromMemory(
  _In_        LPCWSTR    pwszProvName,
  _In_        DWORD      dwProvType,
  _In_        BYTE       *pbData,
  _In_        DWORD      cbData,
  _In_        HWND       hwndOwner,
  _In_        LPCWSTR    pwszKeyName,
  _Inout_opt_ DWORD      *pdwKeySpec,
  _Out_       HCRYPTPROV *phCryptProv,
  _Out_       LPTSTR     *ppwszTmpContainer
);

Parámetros

pwszProvName [in]

Puntero a una cadena terminada en null que contiene el nombre del CSP cuyo tipo se solicita en dwProvType.

dwProvType [in]

Valor DWORD para el tipo csp. Para obtener más información sobre los tipos de CSP, consulte Tipos de proveedor de servicios criptográficos.

pbData [in]

Puntero a un búfer para recibir los datos de contexto. El autor de la llamada debe proporcionar este recurso.

cbData [in]

Valor DWORD que especifica el tamaño, en bytes, del búfer pbData . El autor de la llamada debe proporcionar este valor.

hwndOwner [in]

Si se requiere una contraseña para descifrar los datos de contexto a los que apunta el parámetro pbData , este parámetro es un identificador para el elemento primario del cuadro de diálogo; de lo contrario, es NULL.

pwszKeyName [in]

Puntero a una cadena terminada en null que contiene el nombre de la clave que se va a recuperar.

pdwKeySpec [in, out, optional]

Puntero a un valor DWORD que especifica el tipo de clave. Entre los valores posibles se incluyen AT_KEYEXCHANGE o AT_SIGNATURE.

phCryptProv [out]

Puntero a un identificador para el CSP.

ppwszTmpContainer [out]

Dirección de un puntero a una cadena terminada en null para el nombre del contenedor temporal. La función PvkPrivateKeyAcquireContextFromMemory proporciona el búfer para esta cadena y lo inicializa. Al llamar a PvkPrivateKeyAcquireContextFromMemory, la dirección debe apuntar a un valor NULL .

Valor devuelto

Si se ejecuta correctamente, esta función devuelve TRUE. La función PvkPrivateKeyAcquireContextFromMemory devuelve FALSE si se produce un error.

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