Método IX509PrivateKey::Export (certenroll.h)
O método Export copia a chave privada para uma matriz de bytes. A matriz de bytes é representada por uma cadeia de caracteres codificada em Unicode.
Sintaxe
HRESULT Export(
[in] BSTR strExportType,
[in] EncodingType Encoding,
[out] BSTR *pstrEncodedKey
);
Parâmetros
[in] strExportType
Um valor BSTR que especifica como a chave privada é exportada.
Se a chave tiver sido criada usando um CNG KSP (Provedor de Armazenamento de Chaves), você poderá especificar um dos valores permitidos pelo parâmetro pszBlobType na função NCryptExportKey .
Se a chave tiver sido criada usando um CSP de CryptoAPI (Provedor de Serviços Criptográficos), você poderá especificar um dos valores a seguir do arquivo de cabeçalho Bcrypt.h incluído no Wincrypt.h.
| Valor | Significado |
|---|---|
|
Exporta apenas a parte pública da chave privada. |
|
Exporta toda a chave privada. |
[in] Encoding
Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode a ser aplicado à cadeia de caracteres contida no parâmetro pstrEncodedKey . O valor padrão é XCN_CRYPT_STRING_BASE64.
[out] pstrEncodedKey
Ponteiro para uma variável BSTR que contém a chave privada.
Valor retornado
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 possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.
| Código de retorno | Descrição |
|---|---|
|
A chave foi criada por um CSP cryptoAPI e você especificou um valor diferente de BCRYPT_PRIVATE_KEY_BLOB ou BCRYPT_PUBLIC_KEY_BLOB para o parâmetro strExportType . |
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | certenroll.h |
| DLL | CertEnroll.dll |