Método IWMDRMLicense::CreateSecureDecryptor

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador de Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador de Coletor em vez do SDK do Windows Media Format 11, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método CreateSecureDecryptor cria um objeto descriptografador seguro. O descriptografia seguro difere do descriptografia normal, pois descriptografa o conteúdo e o criptografa novamente de acordo com as configurações especificadas nos parâmetros desse método.

Sintaxe

HRESULT CreateSecureDecryptor(
  [in]      BYTE          *pbCertificate,
  [in]      DWORD         cbCertificate,
  [in]      DWORD         dwCertificateType,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbInitializationVector,
  [in, out] DWORD         *pcbInitializationVector,
  [out]     IWMDRMDecrypt **ppDecryptor
);

Parâmetros

pbCertificate [in]

Certificado do aplicativo de chamada.

cbCertificate [in]

Tamanho do certificado em bytes.

dwCertificateType [in]

O tipo de certificado. Defina como WMDRM_CERTIFICATE_TYPE_XML.

dwFlags [in]

O tipo de proteção de sessão a ser usado para recodificação. Deve ser definido como uma das constantes na tabela a seguir:

Constante Descrição
WMDRM_PROTECTION_TYPE_RC4 Usa criptografia RC4 para criptografia de sessão. Essa é a única proteção de sessão com suporte para esta versão.

pbInitializationVector [out]

Recebe o vetor de inicialização. O vetor de inicialização é criptografado por RSA usando o esquema de preenchimento OAEP com a chave pública RSA encontrada no certificado. Defina como NULL para receber o tamanho do buffer necessário no pcbInitializationVector.

pcbInitializationVector [in, out]

Na entrada, o tamanho do buffer passado como pbInitializationVector. Na saída, o tamanho da parte usada do buffer. Se você passar NULL para pbInitializationVector, esse valor será definido como o tamanho do buffer necessário na saída.

ppDecryptor [out]

Recebe um ponteiro para a interface IWMDRMDecrypt do objeto recém-criado.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.

Comentários

Nenhum.

Requisitos

Requisito Valor
parâmetro
Wmdrmsdk.h

Confira também

IWMDRMLicense Interface