PeerDistServerRetrieveContentInformation 함수(peerdist.h)

PeerDistServerRetrieveContentInformation 함수는 PeerDistServerOpenContentInformation에서 반환된 핸들과 연결된 인코딩된 콘텐츠 정보를 검색합니다.

구문

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

매개 변수

[in] hPeerDist

PeerDistStartup에서 반환된 PEERDIST_INSTANCE_HANDLE.

[in] hContentInfo

PeerDistServerOpenContentInformation에서 반환된 핸들입니다.

cbMaxNumberOfBytes

읽을 최대 바이트 수입니다.

[in, out] pBuffer

콘텐츠 정보 데이터를 수신하는 버퍼에 대한 포인터입니다.

[in] lpOverlapped

OVERLAPPED 구조체에 대한 포인터입니다. 이 함수는 호출자가 콘텐츠에서 시작 오프셋을 지정할 수 없습니다. 오프셋은 hContentInfo당 암시적으로 유지 관리됩니다. Offset 및 OffsetHigh는 예약되어 있으며 0이어야 합니다.

반환 값

함수가 성공하면 반환 값이 ERROR_IO_PENDING. 그렇지 않은 경우에는 함수가 다음 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	하나 이상의 매개 변수가 잘못되었습니다.
ERROR_INVALID_HANDLE	hPeerDist 또는 hContentInfo 핸들이 잘못되었습니다.
PEERDIST_ERROR_NO_MORE	콘텐츠 정보에 대한 EOF에 도달했습니다.
ERROR_ACCESS_DISABLED_BY_POLICY	이 기능은 그룹 정책 사용하지 않도록 설정됩니다.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	서비스를 사용할 수 없습니다.

설명

PeerDistServerRetrieveContentInformation 작업의 성공에 따라 OVERLAPPED 구조체의 Offset 및 OffsetHigh 필드가 검색된 콘텐츠 정보의 ULONGLONG 오프셋으로 채워집니다. OffsetHigh 멤버는 오프셋의 상위 32비트로 설정되고 Offset 멤버는 오프셋의 하위 32비트로 설정됩니다.

GetOverlappedResult 는 lpNumberOfBytesTransferred를 전송된 바이트 수로 채웁니다. 호출자가 완료 포트를 사용하여 피어 배포 API 완성을 처리하는 경우 GetQueuedCompletionStatus의 lpNumberOfBytes 인수가 전송된 바이트 수로 채워집니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	peerdist.h
라이브러리	PeerDist.lib
DLL	PeerDist.dll

추가 정보

PeerDistServerOpenContentInformation

PeerDistStartup