Função PvkPrivateKeyAcquireContextFromMemory

Artigo
06/12/2023

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

Partilhar via