Metodo ISCPSecureQuery::GetDataDemands (mswmdm.h)

Articolo
08/25/2023

Il metodo GetDataDemands segnala quali dati il provider di contenuti protetti deve determinare i diritti e la responsabilità per una parte di contenuto specificata.

Sintassi

HRESULT GetDataDemands(
  [out]     UINT     *pfuFlags,
  [out]     DWORD    *pdwMinRightsData,
  [out]     DWORD    *pdwMinExamineData,
  [out]     DWORD    *pdwMinDecideData,
  [in, out] BYTE [8] abMac
);

Parametri

[out] pfuFlags

Flag che descrivono i dati richiesti dal provider di contenuti sicuri per prendere decisioni. Questo parametro è incluso nel codice di autenticazione del messaggio di output. È necessario usare almeno uno dei flag seguenti.

Flag	Descrizione
WMDM_SCP_RIGHTS_DATA	Il provider di contenuti sicuri necessita di dati per determinare i diritti per il contenuto.
WMDM_SCP_EXAMINE_DATA	Il provider di contenuti sicuri necessita di dati per determinare se è responsabile del contenuto.
WMDM_SCP_DECIDE_DATA	Il provider di contenuti protetti necessita di dati per determinare se consentire il download del contenuto.
WMDM_SCP_EXAMINE_EXTENSION	Il provider di contenuti protetti deve esaminare l'estensione del nome file per determinare se consentire il download del contenuto.
WMDM_SCP_PROTECTED_OUTPUT	Il provider di contenuti protetti richiede un output protetto.
WMDM_SCP_UNPROTECTED_OUTPUT	Il provider di contenuti protetti richiede un output non protetto.

[out] pdwMinRightsData

Puntatore a un DWORD che specifica la quantità minima di dati necessaria per determinare i diritti per questo contenuto. Questo parametro è incluso nel codice di autenticazione del messaggio di output.

[out] pdwMinExamineData

Puntatore a un DWORD contenente il numero minimo di byte di dati che il provider di contenuti protetti deve determinare se è responsabile del contenuto. Questo parametro è incluso nel codice di autenticazione del messaggio di output.

[out] pdwMinDecideData

Puntatore a un DWORD contenente il numero minimo di byte di dati che il provider di contenuti protetti deve determinare se consentire il download del contenuto. Questo parametro è incluso nel codice di autenticazione del messaggio di output.

[in, out] abMac

Matrice di otto byte contenente il codice di autenticazione del messaggio per i dati dei parametri di questo metodo. (WMDM_MAC_LENGTH è definito come 8.)

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, restituisce un codice di errore HRESULT .

Codice restituito	Descrizione
WMDM_E_MAC_CHECK_FAILED	Il codice di autenticazione del messaggio non è valido.
E_INVALIDARG	Un parametro è un puntatore NULL o non valido.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Questo metodo deve essere chiamato prima che venga chiamato uno degli altri metodi di ISCPSecureQuery .

Questo metodo viene chiamato dopo il completamento di qualsiasi scambio di certificati. Il provider di contenuti sicuri compila i parametri con i flag e i dati che ne descrivono i requisiti per prendere decisioni sul contenuto.

Se il provider di contenuti protetti imposta il flag di WMDM_SCP_RIGHTS_DATA, Windows Media Gestione dispositivi invia la quantità di dati specificata in pdwMinRightsData chiamando ISCPSecureQuery::GetRights.

Se il provider di contenuti protetti imposta il flag di WMDM_SCP_EXAMINE_DATA, Windows Media Gestione dispositivi invia la quantità di dati specificata in pdwMinExamineData chiamando ISCPSecureQuery::ExamineData.

Se il provider di contenuti protetti imposta il flag di WMDM_SCP_DECIDE_DATA, Windows Media Gestione dispositivi invia la quantità di dati specificata in pdwMinDecideData chiamando ISCPSecureQuery::MakeDecision.

Se non vengono impostati flag di esame, Windows Media Gestione dispositivi non effettua più chiamate. Se non vengono impostati flag, Windows Media Gestione dispositivi chiama comunque ISCPSecureQuery::ExamineData.

Se questo metodo non restituisce S_OK, Windows Media Gestione dispositivi non effettua ulteriori chiamate a questo provider di contenuto sicuro.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	mswmdm.h
Libreria	Mssachlp.lib

Vedi anche

Interfaccia ISCPSecureQuery

Condividi tramite