Función PvkPrivateKeyAcquireContextFromMemory
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 |
|