Método IWMDRMNetTransmitter::GetRootLicenseResponse
[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 GetRootLicenseResponse gera uma mensagem de resposta de licença raiz.
Sintaxe
HRESULT GetRootLicenseResponse(
[in] BSTR bstrKID,
[out] BYTE **ppbLicenseResponse,
[out] DWORD *pcbLicenseResponse
);
Parâmetros
-
bstrKID [in]
-
Identificador de chave codificado em Base64 a ser usado para a nova licença raiz. O identificador de chave deve ser um valor GUID gerado aleatoriamente.
-
ppbLicenseResponse [out]
-
Endereço de uma variável que recebe o endereço da resposta de licença gerada. Quando terminar com esses dados, você deve liberar a memória chamando CoTaskMemFree.
-
pcbLicenseResponse [out]
-
Endereço de uma variável que recebe o tamanho da resposta de licença, 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 |
|---|---|
|
Uma lista de revogação de conteúdo atualizada é necessária. |
|
O método foi bem-sucedido. |
Comentários
A licença raiz gerada é criada usando as informações dos dados de desafio de licença, que são processados para a interface chamando SetLicenseChallenge.
A licença raiz é usada na geração de licenças folha, o que é feito chamando o método GetLeafLicenseResponse . A interface IWMDRMNetTransmitter mantém uma cópia da licença raiz para esse uso.
A licença raiz criada chamando esse método não tem nenhuma política e está configurada para que não possa ser persistente no dispositivo receptor.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|