Método IWMDRMLicenseQuery::QueryLicenseState
[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 do 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 do 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 QueryLicenseState consulta o repositório de licenças local para obter informações de licença que se aplicam a uma ID de chave para um ou mais direitos específicos.
Sintaxe
HRESULT QueryLicenseState(
[in] BSTR bstrKID,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);
Parâmetros
-
bstrKID [in]
-
ID da chave para a qual consultar. Somente as licenças que se aplicam a essa ID de Chave serão avaliadas.
-
cActionsToQuery [in]
-
O número de ações para as quais consultar. Esse valor deve ser definido como o número de elementos nas matrizes passadas para os parâmetros rgbstrActionsToQuery e rgResultStateData .
-
rgbstrActionsToQuery[] [in]
-
Matriz de um ou mais direitos para os quais consultar. Essa matriz deve conter tantos elementos quanto especificado por cActionsToQuery. Cada elemento deve ser definido como uma das seguintes constantes.
Constante Descrição g_wszWMDRM_LicenseState_Backup Inclua para consultar os detalhes sobre o direito de fazer backup e restaurar a licença. g_wszWMDRM_LicenseState_CollaborativePlay Inclua para consultar os detalhes sobre o direito de compartilhar o conteúdo com um grupo de usuários como parte de um cenário de reprodução colaborativa. g_wszWMDRM_LicenseState_Copy Inclua para consultar os detalhes sobre o direito de copiar o conteúdo para dispositivos externos ou mídia. g_wszWMDRM_LicenseState_CopyToCD Inclua para consultar os detalhes sobre o direito de copiar o conteúdo para CD. g_wszWMDRM_LicenseState_CopyToNonSDMIDevice Inclua para consultar os detalhes sobre o direito de copiar o conteúdo para um dispositivo que não dá suporte à SDMI (iniciativa de mídia digital) segura. g_wszWMDRM_LicenseState_CopyToSDMIDevice Inclua para consultar os detalhes sobre o direito de copiar o conteúdo para um dispositivo que dê suporte ao SDMI. g_wszWMDRM_LicenseState_CreateThumbnailImage Inclua para consultar os detalhes sobre o direito de criar uma imagem em miniatura com base no conteúdo. g_wszWMDRM_LicenseState_Playback Inclua para consultar os detalhes sobre o direito de reproduzir o conteúdo. g_wszWMDRM_LicenseState_PlaylistBurn Inclua para consultar os detalhes sobre o direito de copiar o conteúdo para CD como parte de uma playlist. -
rgResultStateData[] [out]
-
Matriz de uma ou mais estruturas DRM_LICENSE_STATE_DATA que recebem as informações de estado de licença que se aplicam à direita no elemento correspondente do parâmetro rgbstrActionsToQuery .
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 |
|---|---|
|
O método foi bem-sucedido. |
Comentários
Todas as licenças que se aplicam à ID de chave especificada serão pesquisadas e avaliadas. Os resultados são agregados, portanto, cada estrutura de DRM_LICENSE_STATE_DATA pode conter informações de várias licenças.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|