IWSDInboundAttachment::Read 메서드(wsdattachment.h)

원격 호스트에서 보낸 메시지에서 첨부 파일 데이터를 검색합니다.

구문

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

매개 변수

[out] pBuffer

첨부 파일 스트림에서 읽은 데이터를 수신하는 버퍼에 대한 포인터입니다. 애플리케이션 프로그램은 이 데이터 버퍼를 할당하고 해제해야 합니다.

[in] dwBytesToRead

pBuffer 입력 버퍼의 크기(바이트)입니다.

[out] pdwNumberOfBytesRead

첨부 파일 스트림에서 pBuffer 입력 버퍼로 읽은 데이터 바이트 수를 포함하는 DWORD에 대한 포인터입니다.

반환 값

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드	Description
S_OK	메서드가 성공적으로 완료되었습니다.
S_FALSE	첨부 파일 스트림의 끝에 도달했습니다.
E_INVALIDARG	pBuffer 가 NULL입니다.
E_POINTER	pdwNumberofBytesRead 는 NULL입니다.

설명

Read 메서드를 사용하면 애플리케이션이 MIME로 캡슐화된 메시지 첨부 파일의 원격 호스트에서 임의의 데이터를 받을 수 있습니다. WSDAPI는 첨부 파일 스트림이 메시지의 일부로 수신될 때 이 인터페이스를 구현하는 개체를 제공합니다. 읽기 호출은 인바운드 첨부 파일 스트림을 열고 첨부 파일 데이터를 애플리케이션의 버퍼로 전송합니다. Read가 S_OK 또는 S_FALSE 반환하는 경우 pdwNumberofBytesRead는 읽기 바이트 수로 설정되며 버퍼 크기보다 작을 수 있습니다. 읽기 호출은 네트워크 트래픽에서 차단할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wsdattachment.h(Wsdapi.h 포함)
DLL	Wsdapi.dll

추가 정보

IWSDInboundAttachment