Método IWMDRMLicenseQuery::QueryLicenseState
[La característica asociada a esta página, WINDOWS Media Format 11 SDK, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. Lector de origen y escritor receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector fuente 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 QueryLicenseState consulta el almacén de licencias local para obtener información de licencia que se aplica a un identificador de clave para uno o más derechos específicos.
Sintaxis
HRESULT QueryLicenseState(
[in] BSTR bstrKID,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);
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.
-
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 rgResultStateData .
-
rgbstrActionsToQuery[] [in]
-
Matriz de uno o más derechos para los que se va a consultar. Esta matriz debe contener tantos elementos como se especifica en cActionsToQuery. Cada elemento debe establecerse en una de las siguientes constantes.
Constante Descripción g_wszWMDRM_LicenseState_Backup Incluya para consultar los detalles sobre el derecho a realizar copias de seguridad y restaurar la licencia. g_wszWMDRM_LicenseState_CollaborativePlay Incluya para consultar los detalles sobre el derecho a compartir el contenido con un grupo de usuarios como parte de un escenario de reproducción colaborativa. g_wszWMDRM_LicenseState_Copy Incluya para consultar los detalles sobre el derecho a copiar el contenido en dispositivos o medios externos. g_wszWMDRM_LicenseState_CopyToCD Incluya para consultar los detalles sobre el derecho a copiar el contenido en CD. g_wszWMDRM_LicenseState_CopyToNonSDMIDevice Incluya para consultar los detalles sobre el derecho a copiar el contenido en un dispositivo que no admita la iniciativa segura de medios digitales (SDMI). g_wszWMDRM_LicenseState_CopyToSDMIDevice Incluya para consultar los detalles sobre el derecho a copiar el contenido en un dispositivo que admita SDMI. g_wszWMDRM_LicenseState_CreateThumbnailImage Incluya para consultar los detalles sobre el derecho para crear una imagen en miniatura a partir del contenido. g_wszWMDRM_LicenseState_Playback Incluya para consultar los detalles sobre el derecho a reproducir el contenido. g_wszWMDRM_LicenseState_PlaylistBurn Incluya para consultar los detalles sobre el derecho a copiar el contenido en CD como parte de una lista de reproducción. -
rgResultStateData[] [out]
-
Matriz de una o varias estructuras DRM_LICENSE_STATE_DATA que reciben la información de estado de licencia que se aplica a la derecha en el elemento correspondiente del parámetro rgbstrActionsToQuery .
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
Se buscarán y evaluarán todas las licencias que se aplican al identificador de clave especificado. Los resultados se agregan, por lo que cada estructura DRM_LICENSE_STATE_DATA puede contener información de varias licencias.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|