IMDSPObject::Write-Methode (mswmdm.h)

Artikel
03/04/2024

Die Write-Methode schreibt Daten an der aktuellen Position im Objekt in das Objekt. Dieser Vorgang ist nur gültig, wenn das Speicherobjekt eine Datei darstellt.

Syntax

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

Parameter

[in] pData

Zeiger auf den Puffer, der die Daten enthält, die in das Objekt geschrieben werden sollen. Dieser Parameter ist verschlüsselt und muss mit CSecureChannelServer::D ecryptParam mit dem MAC in abMac entschlüsselt werden. Siehe Hinweise.

[in, out] pdwSize

DWORD , das die Anzahl der zu schreibenden Datenbytes enthält. Nach der Rückgabe enthält dieser Parameter die tatsächliche Anzahl geschriebener Bytes. Dieser Parameter muss in den Authentifizierungscodes für Eingabe- und Ausgabenachrichten 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 muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgegeben werden. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.