Metodo ISCPSecureQuery::ExamineData (mswmdm.h)

Articolo
08/25/2023

Il metodo ExamineData determina i diritti e la responsabilità per il contenuto esaminando i dati passati da Windows Media Gestione dispositivi a questo metodo.

Sintassi

HRESULT ExamineData(
  [in]      UINT     fuFlags,
  [in]      LPWSTR   pwszExtension,
  [in]      BYTE     *pData,
  [in]      DWORD    dwSize,
  [in, out] BYTE [8] abMac
);

Parametri

[in] fuFlags

Flag che descrivono i dati offerti al provider di contenuti sicuro per prendere decisioni. I flag seguenti possono essere presenti.

Flag	Descrizione
WMDM_SCP_EXAMINE_DATA	Il parametro pData punta ai dati da esaminare.

[in] pwszExtension

Puntatore all'estensione del nome file da esaminare se il provider di contenuti protetti richiede un'estensione nella chiamata GetDataDemands .

[in] pData

Puntatore ai dati all'inizio del file da esaminare. Questo parametro deve essere incluso nel codice di autenticazione del messaggio di input e deve essere crittografato.

[in] dwSize

DWORD contenente la lunghezza, in byte, dei dati da esaminare. Questo parametro deve essere incluso nel codice di autenticazione del messaggio di input.

[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

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. Il provider di contenuti protetti è responsabile di questo contenuto.
WMDM_E_CALL_OUT_OF_SEQUENCE	Questo metodo è stato chiamato fuori sequenza. GetDataDemands deve essere chiamato per primo.
WMDM_E_MAC_CHECK_FAILED	Il codice di autenticazione del messaggio non è valido.
WMDM_E_MOREDATA	Windows Media Gestione dispositivi deve chiamare di nuovo questo metodo con un altro pacchetto di dati. Le dimensioni del pacchetto sono determinate dal parametro pdwMinExamineData nel metodo GetDataDemands .
S_FALSE	Il provider di contenuti protetti non è responsabile di questo contenuto. Terminare l'interazione con il provider di contenuti protetti.
E_INVALIDARG	Un parametro non è valido o è un puntatore NULL .
E_FAIL	Si è verificato un errore non specificato.

Commenti

Questo metodo viene chiamato dopo il metodo GetDataDemands . Il provider di contenuti protetti usa le informazioni passate in questo metodo per determinare se è responsabile del contenuto. Il parametro fuFlags viene consultato per determinare quali dati sono stati presentati per l'esame. Il parametro pData punta all'inizio dei diritti e dei dati di responsabilità. Il parametro dwSize contiene la lunghezza, espressa in byte, dei diritti e dei dati di responsabilità.

Se il flag WMDM_SCP_EXAMINE_DATA è impostato, il parametro pDataBuffer contiene dwDataLength di byte da esaminare per il provider di contenuto sicuro.

Se questo metodo non restituisce S_OK o WMDM_E_MOREDATA, 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