IMDSPObject::Read-Methode (mswmdm.h)

Die Read-Methode liest Daten aus dem -Objekt an der aktuellen Position. Dieser Vorgang ist nur gültig, wenn das Speicherobjekt eine Datei darstellt.

Syntax

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

Parameter

[out] pData

Zeiger auf einen Puffer, um die vom Objekt gelesenen Daten zu empfangen. Dieser Parameter ist im Authentifizierungscode der Ausgabenachricht enthalten und muss mit CSecureChannelServer::EncryptParam verschlüsselt werden. Siehe Hinweise.

[in, out] pdwSize

Zeiger auf ein DWORD , das die Anzahl der zu lesenden Datenbytes angibt. Nach der Rückgabe enthält dieser Parameter die tatsächliche Menge an gelesenen Daten. Dieser Parameter muss im Authentifizierungscode für Eingabenachrichten enthalten sein.

[in, out] abMac

Array von acht Bytes, die den Nachrichtenauthentifizierungscode für die Parameterdaten dieser Methode enthalten. (WMDM_MAC_LENGTH ist als 8 definiert.)

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

  • Com-Standardfehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Der für die Verschlüsselung verwendete MAC sollte sowohl pData als auch pdwSize in Aufrufen von CSecureChannelServer::MACUpdate enthalten.

Diese Methode ist optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

Verschlüsselung und Entschlüsselung

IMDSPObject-Schnittstelle

IMDSPObject::Close

IMDSPObject::Open

IMDSPObject::Seek

IMDSPObject::Write