Método IEnroll4::createPFXWStr (xenroll.h)

  • Artigo

[Esse método não está mais disponível para uso desde o Windows Server 2008 e o Windows Vista.]

O método createPFXWStr salva a cadeia de certificados e a chave privada aceitas em uma cadeia de caracteres de formato PFX (Troca de Informações Pessoais). O formato PFX também é conhecido como PKCS nº 12. Esse método foi definido pela primeira vez na interface IEnroll4 .

Sintaxe

HRESULT createPFXWStr(
  [in]  LPCWSTR          pwszPassword,
  [out] PCRYPT_DATA_BLOB pblobPFX
);

Parâmetros

[in] pwszPassword

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que representa a senha para a mensagem de formato PFX. Esse valor pode estar vazio ou NULL para indicar que nenhuma senha é usada. Quando terminar de usar a senha, remova as informações confidenciais da memória chamando SecureZeroMemory. Para obter mais informações sobre como proteger a senha, consulte Manipulando senhas.

[out] pblobPFX

Um ponteiro para a estrutura CRYPT_DATA_BLOB que recebe as informações do certificado de formato PFX codificado em base64.

Quando terminar de usar essa memória, libere-a passando o membro pbData dessa estrutura para a função CoTaskMemFree .

Retornar valor

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

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]
Plataforma de Destino Windows
Cabeçalho xenroll.h
Biblioteca Uuid.lib
DLL Xenroll.dll

Confira também

IEnroll4