Поделиться через

Метод IWSDInboundAttachment::Read (wsdattachment.h)

  • Статья

Извлекает данные вложения из сообщения, отправленного удаленным узлом.

Синтаксис

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

Параметры

[out] pBuffer

Указатель на буфер, получающий данные, считанные из потока вложений. Программа приложения отвечает за выделение и освобождение этого буфера данных.

[in] dwBytesToRead

Размер входного буфера pBuffer в байтах.

[out] pdwNumberOfBytesRead

Указатель на DWORD , содержащий количество байтов данных, считанных из потока вложений во входной буфер pBuffer .

Возвращаемое значение

Возможные возвращаемые значения включают, помимо прочего, следующие:

Код возврата Описание
S_OK
 Метод успешно завершен.
S_FALSE
 Достигнут конец потока вложений.
E_INVALIDARG
 pBuffer имеет значение NULL.
E_POINTER
 pdwNumberofBytesRead имеет значение NULL.

Комментарии

Метод Read позволяет приложению получать произвольные данные от удаленного узла во вложении сообщения, инкапсулированного в MIME. WSDAPI предоставит объект, реализующий этот интерфейс, при получении потока вложений как части сообщения. Вызов Read открывает входящий поток вложений и передает данные вложения в буфер приложения. Если функция Read возвращает S_OK или S_FALSE, для параметра pdwNumberofBytesRead устанавливается число прочитанных байтов, которое может быть меньше размера буфера. Вызов Read может блокировать сетевой трафик.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header wsdattachment.h (включая Wsdapi.h)
DLL Wsdapi.dll

См. также раздел

IWSDInboundAttachment