Método IWMDRMLicenseManagement::CreateLicenseRevocationChallenge

[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 CreateLicenseRevocationChallenge gera um desafio de revogação de licença.

Sintaxe

HRESULT CreateLicenseRevocationChallenge(
  [in]  BYTE  *pbMachineID,
  [in]  DWORD cbMachineID,
  [in]  BYTE  *pbChallenge,
  [in]  DWORD cbChallenge,
  [out] BYTE  **ppbChallengeOutput,
  [out] DWORD *pcbChallengeOutput
);

Parâmetros

pbMachineID [in]

Identificador de computador especificado pelo usuário. Esse valor é usado para consultar uma licença no servidor e deve estar em conformidade com o formato que o servidor de licença usa.

cbMachineID [in]

Tamanho, em bytes, do identificador do computador.

pbChallenge [in]

Dados de desafio especificados pelo usuário. Esses dados, além do identificador do computador, são usados para consultar o servidor de licenças para que as licenças sejam revogadas.

cbChallenge [in]

Tamanho, em bytes, dos dados de desafio.

ppbChallengeOutput [out]

Endereço de um ponteiro que recebe o endereço da saída do desafio. Esse buffer são os dados enviados para o serviço de revogação de licença. Quando terminar com esses dados, você deve liberar a memória chamando CoTaskMemFree.

pcbChallengeOutput [out]

Endereço de uma variável que recebe o tamanho dos dados de saída de desafio alocados, em bytes.

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

IWMDRMLicenseManagement Interface