Função PvkPrivateKeySave

Artigo
06/13/2023

Importante

Essa API está preterida. A Microsoft pode remover essa API em versões futuras.

A função PvkPrivateKeySave salva uma chave privada e sua chave pública correspondente em um arquivo especificado.

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 PvkPrivateKeySave(
  _In_ HCRYPTPROV hCryptProv,
  _In_ HANDLE     hFile,
  _In_ DWORD      dwKeySpec,
  _In_ HWND       hwndOwner,
  _In_ LPCWSTR    pwszKeyName,
  _In_ DWORD      dwFlags
);

Parâmetros

hCryptProv [in]: Um identificador para um provedor de serviços criptográficos (CSP).
hFile [in]: Um identificador para um arquivo criado com permissão inicial de leitura/gravação e permissão somente leitura subsequente.
dwKeySpec [in]: Um inteiro longo para o tipo de chave. Os valores possíveis incluem AT_KEYEXCHANGE ou AT_SIGNATURE.
hwndOwner [in]: Se uma senha for necessária para criptografar a chave privada, esse parâmetro será um identificador para o pai da caixa de diálogo; caso contrário, será NULL.
pwszKeyName [in]: Um ponteiro para uma cadeia de caracteres terminada em nulo para o nome da chave a ser salva.
dwFlags [in]: Um valor DWORD que especifica opções adicionais para a função. Para obter mais informações, consulte o parâmetro dwFlags em CryptExportKey.

Valor retornado

Após o êxito, essa função retorna TRUE. A função PvkPrivateKeySave 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