IPipeByte::P ull 메서드(objidlbase.h)

파이프 소스에서 바이트 형식의 데이터를 검색합니다.

구문

HRESULT Pull(
  [out] BYTE  *buf,
  [in]  ULONG cRequest,
  [out] ULONG *pcReturned
);

매개 변수

[out] buf

데이터를 수신하는 메모리 버퍼에 대한 포인터입니다. 버퍼는 cRequest에 지정된 바이트 수를 최소한 보유할 수 있어야 합니다.

[in] cRequest

요청된 바이트 수입니다.

[out] pcReturned

반환된 실제 바이트 수입니다.

반환 값

이 메서드는 S_OK 반환하여 데이터가 성공적으로 검색되었음을 나타냅니다.

설명

Pull 메서드가 호출되면 파이프 공급자로부터 데이터가 요청됩니다. 호출자는 cRequest 매개 변수에 지정된 바이트 수 이상을 보유하는 버퍼를 제공해야 합니다. 프록시는 제공된 버퍼로 데이터를 숨기지 않고 pcReturned에 실제로 제공된 바이트 수를 설정합니다. pcReturned 매개 변수는 cRequest보다 작거나 같을 수 있지만 결코 크지 않습니다. pcReturned이 0이면 더 이상 데이터가 없음을 나타냅니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 objidlbase.h(ObjIdl.h 포함)

추가 정보

IPipeByte