Método IX509Enrollment::CreatePFX (certenroll.h)

O método CreatePFX cria uma mensagem PFX (Troca de Informações Pessoais). A mensagem está contida em uma matriz de bytes codificada usando DER (Distinguished Encoding Rules ), conforme definido pelo padrão ASN.1 ( Abstract Syntax Notation One ). A matriz de bytes codificada em DER é representada por uma cadeia de caracteres que é uma sequência binária pura ou codificada por Unicode.

Sintaxe

HRESULT CreatePFX(
  [in]  BSTR             strPassword,
  [in]  PFXExportOptions ExportOptions,
  [in]  EncodingType     Encoding,
  [out] BSTR             *pValue
);

Parâmetros

[in] strPassword

Uma variável BSTR que contém uma senha para a mensagem PFX. Isso pode ser NULL para indicar que nenhuma senha é usada. Quando terminar de usar a senha, desmarque-a da memória chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger a senha, consulte Como lidar com senhas.

[in] ExportOptions

Um valor de enumeração PFXExportOptions que especifica quanto da cadeia de certificados é exportada. Você pode exportar somente o certificado, a cadeia de certificados sem a raiz ou toda a cadeia.

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode aplicada à mensagem codificada em DER. O valor padrão é XCN_CRYPT_STRING_BASE64.

[out] pValue

Ponteiro para uma variável BSTR que contém a mensagem PFX codificada em DER.

Valor de retorno

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

O formato PFX também é conhecido como PKCS nº 12. O método CreatePFX :

• Abre o repositório de certificados na memória do provedor padrão.
• Adiciona o certificado instalado ao repositório ou cria a cadeia de certificados adiciona um link a ele.
• Exporta o certificado e a chave privada para uma mensagem PFX, dependendo das opções de exportação especificadas.
• Codifica a mensagem exportada usando DER.

Antes de chamar esse método, você deve inicializar o objeto IX509Enrollment chamando um dos métodos a seguir.

• inicializar
• InitializeFromRequest
• InitializeFromTemplateName

Requirements

Consulte também

IX509Enrollment