Método IX509PrivateKey::Export (certenroll.h)

  • Artigo

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
BCRYPT_PUBLIC_KEY_BLOB
 Exporta apenas a parte pública da chave privada.
BCRYPT_PRIVATE_KEY_BLOB
 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
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)
 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

Confira também

IX509PrivateKey