Metodo IWMDRMDeviceApp::AcquireDeviceData

Articolo
06/12/2023

Il metodo AcquireDeviceData inizializza o reimposta un orologio sicuro del dispositivo.

Sintassi

HRESULT AcquireDeviceData(
  [in]  IWMDMDevice    *pDevice,
  [in]  IWMDMProgress3 *pProgressCallback,
  [in]  DWORD          dwFlags,
  [out] DWORD          *pdwStatus
);

Parametri

pDevice [in]

Puntatore a un'interfaccia IWMDMDevice per il dispositivo che segnalerà i dati di misurazione.

pProgressCallback [in]

Callback di stato tramite cui l'applicazione può tenere traccia dello stato dell'evento o annullare l'evento. Lo stato di avanzamento viene identificato dal parametro EventId dei metodi IWMDMProgress3 .

dwFlags [in]

OR logico di uno o entrambi i flag seguenti, che specifica l'azione da eseguire. Questo valore viene recuperato dal parametro pdwStatus di IWMDRMDeviceApp::QueryDeviceStatus o IWMDRMDeviceApp2::QueryDeviceStatus2. È possibile usare direttamente il flag pdwStatus .

Flag	Descrizione
WMDRM_DEVICE_NEEDCLOCK	Acquisire un orologio da un server di clock sicuro.
WMDRM_DEVICE_REFRESHCLOCK	Aggiornare l'orologio da un server di clock sicuro.

pdwStatus [out]

Uno dei valori DWORD seguenti che specifica lo stato restituito dal dispositivo.

Stato	Descrizione
0	L'azione non è supportata.
1	Non è stato possibile acquisire l'orologio sicuro del dispositivo dal servizio.
2	Impossibile impostare l'orologio sicuro del dispositivo.
3	L'orologio sicuro del dispositivo è stato impostato.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
DRM_E_INVALIDARG	Uno o più argomenti non sono validi.
NS_E_DEVICE_NOT_WMDRM_DEVICE	Il dispositivo specificato non è un dispositivo compatibile con DRM Windows Media.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK	Impossibile recuperare la richiesta di verifica dell'orologio sicuro dal dispositivo o non è possibile recuperare l'URL dell'orologio sicuro dalla richiesta di verifica.
NS_E_DRM_UNABLE_TO_GET_SECURE_CLOCK_FROM_SERVER	Impossibile recuperare la risposta dell'orologio sicuro dal server di clock sicuro.
NS_E_DRM_UNABLE_TO_SET_SECURE_CLOCK	Impossibile inviare la richiesta di orologio sicuro al dispositivo oppure non è stato possibile impostare l'orologio.

Commenti

Si tratta di un metodo asincrono; Il dispositivo deve attendere il callback IWMDMProgress::End per questa operazione prima di tentare di riprodurre qualsiasi contenuto concesso in licenza.

Un'applicazione può sapere se il dispositivo deve reimpostare o aggiornare l'orologio chiamando IWMDRMDeviceApp::QueryDeviceStatus o IWMDRMDeviceApp2::QueryDeviceStatus2.

L'applicazione deve avere una connessione Internet per consentirla di acquisire o reimpostare un orologio sicuro.

Requisiti

Requisito	Valore
Intestazione	WMDRMDeviceApp.h (richiede anche Wmdrmdeviceapp_i.c, compilato da WMDRMDeviceApp.idl)
Libreria	Mssachlp.lib

Vedi anche

Gestione del contenuto protetto nell'applicazione
Interfaccia IWMDMDevice
Interfaccia IWMDMProgress3
Interfaccia IWMDRMDeviceApp

Condividi tramite