Função PvkPrivateKeyAcquireContextFromMemory
Importante
Essa API está preterida. A Microsoft pode remover essa API em versões futuras.
A função PvkPrivateKeyAcquireContextFromMemory cria um contêiner temporário no CSP ( provedor de serviços criptográficos ) e carrega uma chave privada da memória no contêiner.
Observação
Essa função não tem nenhum arquivo de cabeçalho associado ou biblioteca de importação. Para chamar essa função, você deve criar um arquivo de cabeçalho definido pelo usuário e usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Mssign32.dll.
Sintaxe
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]
-
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do CSP cujo tipo é solicitado em dwProvType.
-
dwProvType [in]
-
Um valor DWORD para o tipo CSP. Para obter mais informações sobre tipos CSP, consulte Tipos de provedor criptográfico.
-
pbData [in]
-
Um ponteiro para um buffer para receber os dados de contexto. O chamador deve fornecer esse recurso.
-
cbData [in]
-
Um valor DWORD que especifica o tamanho, em bytes, do buffer pbData . O chamador deve fornecer esse valor.
-
hwndOwner [in]
-
Se uma senha for necessária para descriptografar os dados de contexto apontados pelo parâmetro pbData , esse parâmetro será um identificador para o pai da caixa de diálogo; caso contrário, ele é NULL.
-
pwszKeyName [in]
-
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da chave a ser recuperada.
-
pdwKeySpec [in, out, optional]
-
Um ponteiro para um valor DWORD que especifica o tipo de chave. Os valores possíveis incluem AT_KEYEXCHANGE ou AT_SIGNATURE.
-
phCryptProv [out]
-
Um ponteiro para um identificador para o CSP.
-
ppwszTmpContainer [out]
-
O endereço de um ponteiro para uma cadeia de caracteres terminada em nulo para o nome do contêiner temporário. A função PvkPrivateKeyAcquireContextFromMemory fornece o buffer para essa cadeia de caracteres e a inicializa. Ao chamar PvkPrivateKeyAcquireContextFromMemory, o endereço deve apontar para um valor NULL .
Valor retornado
Após o sucesso, essa função retorna TRUE. A função PvkPrivateKeyAcquireContextFromMemory retornará FALSE se falhar.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| DLL |
|