ISCPSecureQuery ::ExamineData, méthode (mswmdm.h)

Article
08/25/2023

La méthode ExamineData détermine les droits et la responsabilité du contenu en examinant les données que Windows Media Gestionnaire de périphériques transmet à cette méthode.

Syntaxe

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

Paramètres

[in] fuFlags

Indicateurs décrivant les données offertes au fournisseur de contenu sécurisé pour prendre des décisions. Les indicateurs suivants peuvent être présents.

Indicateur	Description
WMDM_SCP_EXAMINE_DATA	Le paramètre pData pointe vers les données à examiner.

[in] pwszExtension

Pointeur vers l’extension de nom de fichier à examiner si le fournisseur de contenu sécurisé demande une extension dans l’appel GetDataDemands .

[in] pData

Pointeur vers les données au début du fichier à examiner. Ce paramètre doit être inclus dans le code d’authentification du message d’entrée et doit être chiffré.

[in] dwSize

DWORD qui contient la longueur, en octets, des données à examiner. Ce paramètre doit être inclus dans le code d’authentification du message d’entrée.

[in, out] abMac

Tableau de huit octets contenant le code d’authentification de message pour les données de paramètre de cette méthode. (WMDM_MAC_LENGTH est défini comme 8.)

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK Le fournisseur de contenu sécurisé est responsable de ce contenu.
WMDM_E_CALL_OUT_OF_SEQUENCE	Cette méthode a été appelée hors séquence. GetDataDemands doit être appelé en premier.
WMDM_E_MAC_CHECK_FAILED	Le code d’authentification du message n’est pas valide.
WMDM_E_MOREDATA	Windows Media Gestionnaire de périphériques devez appeler à nouveau cette méthode avec un autre paquet de données. La taille du paquet est déterminée par le paramètre pdwMinExamineData dans la méthode GetDataDemands .
S_FALSE	Le fournisseur de contenu sécurisé n’est pas responsable de ce contenu. Mettre fin à l’interaction avec le fournisseur de contenu sécurisé.
E_INVALIDARG	Un paramètre n’est pas valide ou est un pointeur NULL .
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Cette méthode est appelée après la méthode GetDataDemands . Le fournisseur de contenu sécurisé utilise les informations transmises dans cette méthode pour déterminer s’il est responsable du contenu. Le paramètre fuFlags est consulté pour déterminer quelles données ont été présentées pour examen. Le paramètre pData pointe vers le début des données de droits et de responsabilité. Le paramètre dwSize contient la longueur, en octets, des données de droits et de responsabilité.

Si l’indicateur WMDM_SCP_EXAMINE_DATA est défini, le paramètre pDataBuffer contient dwDataLength d’octets que le fournisseur de contenu sécurisé doit examiner.

Si cette méthode ne retourne pas S_OK ou WMDM_E_MOREDATA, Windows Media Gestionnaire de périphériques n’effectue plus d’appels à ce fournisseur de contenu sécurisé.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

ISCPSecureQuery Interface

Partager via