Método IWMDRMLicenseQuery::QueryActionAllowed
[La característica asociada a esta página, SDK de Windows Media Format 11, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. El lector de origen y el sistema de escritura receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector de origen y escritor receptor en lugar del SDK de Windows Media Format 11, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El método QueryActionAllowed realiza una consulta en el almacén de licencias local para recuperar el estado de licencia de una o varias acciones DRM que se aplican a un identificador de clave especificado.
Sintaxis
HRESULT QueryActionAllowed(
[in] BSTR bstrKID,
[in] BSTR bstrMinReqIndivVersion,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DWORD rgdwQueryResult[]
);
Parámetros
-
bstrKID [in]
-
Identificador de clave para el que se va a consultar. Solo se evaluarán las licencias que se aplican a este identificador de clave.
-
bstrMinReqIndivVersion [in]
-
Versión de seguridad mínima especificada en el encabezado del archivo ASF. Este parámetro es opcional. Pase NULL para realizar la consulta sin esta información.
-
cActionsToQuery [in]
-
Número de acciones para las que se va a consultar. Este valor debe establecerse en el número de elementos de las matrices pasadas para los parámetros rgbstrActionsToQuery y rgdwQueryResult .
-
rgbstrActionsToQuery[] [in]
-
Matriz de uno o más derechos para los que se va a consultar. Esta matriz debe contener todos los elementos especificados por cActionsToQuery. Cada elemento debe establecerse en una de las siguientes constantes:
Constante Descripción g_wszWMDRM_ActionAllowed_Playback Incluya para consultar el derecho a reproducir el contenido. g_wszWMDRM_ActionAllowed_Copy Incluya para consultar el derecho a copiar el contenido en dispositivos o medios externos. g_wszWMDRM_ActionAllowed_PlaylistBurn Incluya para consultar el derecho a copiar el contenido en CD como parte de una lista de reproducción. g_wszWMDRM_ActionAllowed_CreateThumbnailImage Incluya para consultar el derecho para crear una imagen en miniatura a partir del contenido. g_wszWMDRM_ActionAllowed_CopyToCD Incluya para consultar el derecho a copiar el contenido en CD. -
rgdwQueryResult[] [out]
-
Matriz de una o varias variables DWORD que reciben los resultados de la consulta para los derechos especificados por rgbstrActionsToQuery. Si se permite una acción, el elemento correspondiente se establece en cero. Si no se permite una acción, el elemento se establece en uno o varios valores de la enumeración DRM_ACTION_ALLOWED_QUERY_RESULTS combinada mediante la operación OR bit a bit. Esta matriz debe contener todos los elementos especificados por cActionsToQuery.
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
Observaciones
Al consultar los derechos de reproducción y copia, obtendrá resultados más precisos estableciendo primero parámetros de entorno. Use el método SetActionAllowedQueryParams para establecer los parámetros del entorno. Los resultados de las consultas para el derecho de quema no se ven afectados por los parámetros ambientales; Puede usar de forma segura los valores predeterminados.
Los resultados devueltos por el método QueryActionAllowed se agregan desde cero o más licencias en el almacén de licencias local. Es posible que el método no busque todas las licencias que se aplican al identificador de clave si encuentra un resultado habilitado.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|