ISCPSecureQuery3 ::GetRightsOnClearChannel, méthode (mswmdm.h)

Article
02/29/2024

La méthode GetRightsOnClearChannel récupère les informations de droits pour le contenu actuel sur un canal clair.

Syntaxe

HRESULT GetRightsOnClearChannel(
  [in]  BYTE                *pData,
  [in]  DWORD               dwSize,
  [in]  BYTE                *pbSPSessionKey,
  [in]  DWORD               dwSessionKeyLen,
  [in]  IMDSPStorageGlobals *pStgGlobals,
  [in]  IWMDMProgress3      *pProgressCallback,
  [out] PWMDMRIGHTS         *ppRights,
  [out] UINT                *pnRightsCount
);

Paramètres

[in] pData

Pointeur vers l’objet de données.

[in] dwSize

Nombre d’octets de données dans la mémoire tampon pData .

[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.

[in] dwSessionKeyLen

Longueur du tableau d’octets vers lequel pointe pbSPSessionKey .

[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é.

[in] pProgressCallback

Pointeur vers une interface IWMDMProgress3 .

[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.

[out] pnRightsCount

Nombre de structures WMDMRIGHTS dans le tableau ppRights .

Valeur retournée

Si la méthode réussit, retourne S_OK. Si la méthode échoue, 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. ISCPSecureQuery ::GetDataDemands , puis ISCPSecureQuery ::ExamineData doivent être appelés, 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 nécessaires 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 est identique à ISCPSecureQuery ::GetRights , sauf que les paramètres passés à cette méthode ne sont pas chiffrés. Par conséquent, cette méthode est plus efficace.