Método IEnroll4::createPFXWStr (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 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 |