Método ICEnroll4::createPFX (xenroll.h)

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

O método createPFX 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 ICEnroll4 .

Sintaxe

HRESULT createPFX(
  [in]  BSTR strPassword,
  [out] BSTR *pstrPFX
);

Parâmetros

[in] strPassword

Uma 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, limpe-a da memória chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger a senha, consulte Manipulando senhas.

[out] pstrPFX

Um ponteiro para um BSTR que recebe as informações de certificado de formato PFX codificado em base64. Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString .

Valor retornado

C++

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.

VB

O valor retornado é uma String que contém as informações de certificado de formato PFX.

Comentários

Esse método é desabilitado quando o Controle de Registro de Certificado é executado como um controle com script.

Requisitos

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