Metodo IWSDInboundAttachment::Read (wsdattachment.h)

Articolo
03/15/2023

Recupera i dati degli allegati da un messaggio inviato da un host remoto.

Sintassi

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

Parametri

[out] pBuffer

Puntatore a un buffer che riceve i dati letti dal flusso di allegati. Il programma dell'applicazione è responsabile dell'allocazione e della liberazione di questo buffer di dati.

[in] dwBytesToRead

Dimensioni del buffer di input pBuffer , in byte.

[out] pdwNumberOfBytesRead

Puntatore a un DWORD contenente il numero di byte di dati letti dal flusso di allegati nel buffer di input pBuffer .

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai seguenti:

Codice restituito	Descrizione
S_OK	Il metodo è stato completato correttamente.
S_FALSE	È stata raggiunta la fine del flusso di allegati.
E_INVALIDARG	pBuffer è NULL.
E_POINTER	pdwNumberofBytesRead è NULL.

Commenti

Il metodo Read consente a un'applicazione di ricevere dati arbitrari da un host remoto in un allegato di messaggio incapsulato MIME. WSDAPI fornirà un oggetto che implementa questa interfaccia quando un flusso di allegati viene ricevuto come parte di un messaggio. La chiamata a Read apre il flusso degli allegati in ingresso e trasferisce i dati degli allegati nel buffer dell'applicazione. Se Read restituisce S_OK o S_FALSE, pdwNumberofBytesRead viene impostato sul numero di byte letti, che può essere minore delle dimensioni del buffer. La chiamata di lettura può bloccare il traffico di rete.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wsdattachment.h (include Wsdapi.h)
DLL	Wsdapi.dll

Vedi anche

IWSDInboundAttachment

Condividi tramite