Método IWMDRMLicenseQuery::QueryActionAllowed
[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 QueryActionAllowed executa uma consulta no repositório de licenças local para recuperar a licença status para uma ou mais ações drm que se aplicam a uma ID de chave especificada.
Sintaxe
HRESULT QueryActionAllowed(
[in] BSTR bstrKID,
[in] BSTR bstrMinReqIndivVersion,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DWORD rgdwQueryResult[]
);
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.
-
bstrMinReqIndivVersion [in]
-
A versão mínima de segurança especificada no cabeçalho do arquivo ASF. Esse parâmetro é opcional. Passe NULL para executar a consulta sem essas informações.
-
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 rgdwQueryResult .
-
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_ActionAllowed_Playback Inclua para consultar o direito de reproduzir o conteúdo. g_wszWMDRM_ActionAllowed_Copy Inclua para consultar o direito de copiar o conteúdo para dispositivos externos ou mídia. g_wszWMDRM_ActionAllowed_PlaylistBurn Inclua para consultar o direito de copiar o conteúdo para CD como parte de uma playlist. g_wszWMDRM_ActionAllowed_CreateThumbnailImage Inclua para consultar o direito de criar uma imagem em miniatura do conteúdo. g_wszWMDRM_ActionAllowed_CopyToCD Inclua para consultar o direito de copiar o conteúdo para CD. -
rgdwQueryResult[] [out]
-
Matriz de uma ou mais variáveis DWORD que recebem os resultados da consulta para os direitos especificados por rgbstrActionsToQuery. Se uma ação for permitida, o elemento correspondente será definido como zero. Se uma ação não for permitida, o elemento será definido como um ou mais valores da enumeração DRM_ACTION_ALLOWED_QUERY_RESULTS combinada usando a operação OR bit a bit. Essa matriz deve conter tantos elementos quanto especificado por cActionsToQuery.
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
Ao consultar direitos de reprodução e cópia, você obterá resultados mais precisos definindo primeiro os parâmetros ambientais. Use o método SetActionAllowedQueryParams para definir os parâmetros ambientais. Os resultados das consultas para o direito de queima não são afetados pelos parâmetros ambientais; você pode usar com segurança os padrões.
Os resultados retornados pelo método QueryActionAllowed são agregados de zero ou mais licenças no repositório de licenças local. O método pode não pesquisar todas as licenças que se aplicam à ID da chave se encontrar um resultado habilitado.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|