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

Article
08/25/2023

La méthode GetDataDemands indique les données dont le fournisseur de contenu sécurisé a besoin pour déterminer les droits et la responsabilité d’un élément de contenu spécifié.

Syntaxe

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

Paramètres

[out] pfuFlags

Indicateurs décrivant les données requises par le fournisseur de contenu sécurisé pour prendre des décisions. Ce paramètre est inclus dans le code d’authentification du message de sortie. Au moins un des indicateurs suivants doit être utilisé.

Indicateur	Description
WMDM_SCP_RIGHTS_DATA	Le fournisseur de contenu sécurisé a besoin de données pour déterminer les droits pour le contenu.
WMDM_SCP_EXAMINE_DATA	Le fournisseur de contenu sécurisé a besoin de données pour déterminer s’il est responsable du contenu.
WMDM_SCP_DECIDE_DATA	Le fournisseur de contenu sécurisé a besoin de données pour déterminer s’il faut autoriser le téléchargement du contenu.
WMDM_SCP_EXAMINE_EXTENSION	Le fournisseur de contenu sécurisé doit examiner l’extension de nom de fichier pour déterminer s’il faut autoriser le téléchargement du contenu.
WMDM_SCP_PROTECTED_OUTPUT	Le fournisseur de contenu sécurisé a besoin d’une sortie protégée.
WMDM_SCP_UNPROTECTED_OUTPUT	Le fournisseur de contenu sécurisé a besoin d’une sortie non protégée.

[out] pdwMinRightsData

Pointeur vers un DWORD spécifiant la quantité minimale de données nécessaire pour déterminer les droits pour ce contenu. Ce paramètre est inclus dans le code d’authentification du message de sortie.

[out] pdwMinExamineData

Pointeur vers un DWORD contenant le nombre minimal d’octets de données dont le fournisseur de contenu sécurisé a besoin pour déterminer s’il est responsable du contenu. Ce paramètre est inclus dans le code d’authentification du message de sortie.

[out] pdwMinDecideData

Pointeur vers un DWORD contenant le nombre minimal d’octets de données dont le fournisseur de contenu sécurisé a besoin pour déterminer s’il faut autoriser le téléchargement du contenu. Ce paramètre est inclus dans le code d’authentification du message de sortie.

[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 sur 8.)

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, elle retourne un code d’erreur HRESULT .

Code de retour	Description
WMDM_E_MAC_CHECK_FAILED	Le code d’authentification du message n’est pas valide.
E_INVALIDARG	Un paramètre est un pointeur non valide ou NULL .
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Cette méthode doit être appelée avant l’appel de l’une des autres méthodes de ISCPSecureQuery .

Cette méthode est appelée une fois les échanges de certificats terminés. Le fournisseur de contenu sécurisé remplit les paramètres avec les indicateurs et les données qui décrivent ses exigences pour prendre des décisions concernant le contenu.

Si le fournisseur de contenu sécurisé définit l’indicateur WMDM_SCP_RIGHTS_DATA, Windows Media Gestionnaire de périphériques envoie la quantité de données spécifiée dans pdwMinRightsData en appelant ISCPSecureQuery ::GetRights.

Si le fournisseur de contenu sécurisé définit l’indicateur WMDM_SCP_EXAMINE_DATA, Windows Media Gestionnaire de périphériques envoie la quantité de données spécifiée dans pdwMinExamineData en appelant ISCPSecureQuery ::ExamineData.

Si le fournisseur de contenu sécurisé définit l’indicateur WMDM_SCP_DECIDE_DATA, Windows Media Gestionnaire de périphériques envoie la quantité de données spécifiée dans pdwMinDecideData en appelant ISCPSecureQuery ::MakeDecision.

Si aucun indicateur d’examen n’est défini, Windows Media Gestionnaire de périphériques n’effectue plus d’appels. Si aucun indicateur de décision n’est défini, Windows Media Gestionnaire de périphériques appelle toujours ISCPSecureQuery ::ExamineData.

Si cette méthode ne retourne pas S_OK, Windows Media Gestionnaire de périphériques n’effectue pas d’autres 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