IWSDInboundAttachment::Read-Methode (wsdattachment.h)

Ruft Anlagendaten aus einer Nachricht ab, die von einem Remotehost gesendet wird.

Syntax

HRESULT Read(
  [out] BYTE    *pBuffer,
  [in]  DWORD   dwBytesToRead,
  [out] LPDWORD pdwNumberOfBytesRead
);

Parameter

[out] pBuffer

Zeiger auf einen Puffer, der die aus dem Anlagendatenstrom gelesenen Daten empfängt. Das Anwendungsprogramm ist für die Zuweisung und Freigabe dieses Datenpuffers verantwortlich.

[in] dwBytesToRead

Größe des pBuffer-Eingabepuffers in Byte.

[out] pdwNumberOfBytesRead

Zeiger auf ein DWORD , das die Anzahl der Bytes von Daten enthält, die aus dem Anlagendatenstrom in den pBuffer-Eingabepuffer gelesen werden.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem:

Hinweise

Die Read-Methode ermöglicht es einer Anwendung, beliebige Daten von einem Remotehost in einer MIME-gekapselten Nachrichtenanlage zu empfangen. WSDAPI stellt ein Objekt bereit, das diese Schnittstelle implementiert, wenn ein Anlagendatenstrom als Teil einer Nachricht empfangen wird. Der Aufruf von Read öffnet den eingehenden Anlagendatenstrom und überträgt die Anlagendaten in den Puffer der Anwendung. Wenn Read S_OK oder S_FALSE zurückgibt, wird pdwNumberofBytesRead auf die Anzahl der gelesenen Bytes festgelegt, die kleiner als die Größe des Puffers sein kann. Der Leseaufruf kann den Netzwerkdatenverkehr blockieren.

Anforderungen

Weitere Informationen

IWSDInboundAttachment