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

Article
02/29/2024

La méthode GetRights récupère les informations de droits pour l’élément de contenu actuel. Les droits sont spécifiques au fichier.

Syntaxe

HRESULT GetRights(
  [in]      BYTE                *pData,
  [in]      DWORD               dwSize,
  [in]      BYTE                *pbSPSessionKey,
  [in]      DWORD               dwSessionKeyLen,
  [in]      IMDSPStorageGlobals *pStgGlobals,
  [out]     PWMDMRIGHTS         *ppRights,
  [out]     UINT                *pnRightsCount,
  [in, out] BYTE [8]            abMac
);

Paramètres

[in] pData

Pointeur vers les données demandées par GetDataDemands. Ce paramètre doit être inclus dans le code d’authentification du message d’entrée et doit être chiffré.

[in] dwSize

Nombre d’octets de données dans la mémoire tampon pData . Ce paramètre doit être inclus dans le code d’authentification du message d’entrée.

[in] pbSPSessionKey

Pointeur vers un tableau d’octets contenant la clé de session pour sécuriser la communication avec le fournisseur de services vers lequel pStgGlobals pointe. Ce paramètre doit être inclus dans le code d’authentification du message d’entrée et doit être chiffré.

[in] dwSessionKeyLen

Longueur du tableau d’octets vers lequel pbSPSessionKey pointe. Ce paramètre doit être inclus dans le code d’authentification du message d’entrée.

[in] pStgGlobals

Pointeur vers une interface IWMDMStorageGlobals sur le stockage racine du média ou de l’appareil vers ou à partir duquel le fichier est transféré.

[out] ppRights

Pointeur vers un tableau de structures WMDMRIGHTS contenant les informations de droits pour cet objet. Le tableau est alloué par cette méthode et doit être libéré à l’aide de CoTaskMemFree. Ce paramètre est inclus dans le code d’authentification du message de sortie.

[out] pnRightsCount

Nombre de structures WMDMRIGHTS dans le tableau ppRights . 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_CALL_OUT_OF_SEQUENCE	Cette méthode a été appelée hors séquence. GetDataDemands , puis ExamineData doivent être appelés en premier, dans cet ordre.
WMDM_E_MAC_CHECK_FAILED	Le code d’authentification du message n’est pas valide.
WMDM_E_NORIGHTS	L’appelant ne dispose pas des droits requis pour effectuer l’opération demandée.
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 ne doit pas être appelée tant que GetDataDemands , puis ExamineData n’ont pas été appelés, dans cet ordre.

Configuration requise

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

Voir aussi

ISCPSecureQuery, interface

IWMDMStorageGlobals, interface

WMDMRIGHTS

Partager via