Partager via


IMDSPObject ::Read, méthode (mswmdm.h)

La méthode Read lit les données de l’objet à la position actuelle. Cette opération n’est valide que si l’objet de stockage représente un fichier.

Syntaxe

HRESULT Read(
  [out]     BYTE     *pData,
  [in, out] DWORD    *pdwSize,
  [in, out] BYTE [8] abMac
);

Paramètres

[out] pData

Pointeur vers une mémoire tampon pour recevoir les données lues à partir de l’objet. Ce paramètre est inclus dans le code d’authentification du message de sortie et doit être chiffré à l’aide de CSecureChannelServer ::EncryptParam. Consultez la section Notes.

[in, out] pdwSize

Pointeur vers un DWORD spécifiant le nombre d’octets de données à lire. Au retour, ce paramètre contient la quantité réelle de données lues. 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. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

  • Codes d’erreur COM standard
  • Codes d’erreur Windows convertis en valeurs HRESULT
  • Codes d’erreur Gestionnaire de périphériques Windows Media
Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Le MAC utilisé pour le chiffrement doit inclure pData et pdwSize dans les appels à CSecureChannelServer ::MACUpdate.

Cette méthode est facultative. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Configuration requise

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

Voir aussi

Chiffrement et déchiffrement

IMDSPObject Interface

IMDSPObject ::Close

IMDSPObject ::Open

IMDSPObject ::Seek

IMDSPObject ::Write