PeerDistClientAddData 함수(peerdist.h)

  • 아티클

PeerDistClientAddData 함수는 로컬 캐시에 콘텐츠를 제공하는 데 사용됩니다. 일반적으로 이 작업은 PeerDistClientBlockRead 또는 PeerDistClientStreamRead가 ERROR_TIMEOUT 완료되거나PEERDIST_ERROR_MISSING_DATA 때 표시된 대로 로컬 네트워크에서 데이터를 찾을 수 없는 경우에 수행됩니다.

구문

DWORD PeerDistClientAddData(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in] PEERDIST_CONTENT_HANDLE  hContentHandle,
       DWORD                    cbNumberOfBytes,
  [in] PBYTE                    pBuffer,
  [in] LPOVERLAPPED             lpOverlapped
);

매개 변수

[in] hPeerDist

PeerDistStartup에서 반환된 PEERDIST_INSTANCE_HANDLE.

[in] hContentHandle

PeerDistClientOpenContent에서 반환된 PEERDIST_CONTENT_HANDLE.

cbNumberOfBytes

로컬 캐시에 추가할 바이트 수입니다.

[in] pBuffer

로컬 캐시에 추가할 데이터가 포함된 버퍼에 대한 포인터입니다. 이 버퍼는 추가 작업 기간 동안 유효한 상태로 유지되어야 합니다. 호출자는 추가 작업이 완료될 때까지 이 버퍼를 사용하면 안됩니다.

[in] lpOverlapped

OVERLAPPED 구조체에 대한 포인터입니다. 이 데이터가 추가되는 콘텐츠 시작 부분의 바이트 오프셋은 OVERLAPPED 구조체의 Offset 및 OffsetHigh 멤버를 설정하여 지정됩니다. OffsetHigh 멤버는 바이트 오프셋의 상위 32비트로 설정해야 하며 Offset 멤버는 바이트 오프셋의 하위 32비트로 설정해야 합니다.

반환 값

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

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

설명

이 함수와 함께 추가되고 통과된 확인 데이터는 다른 피어 또는 호스트된 캐시에서 다운로드할 수 있습니다. 피어 배포 서비스는 이 데이터를 로컬 캐시에 저장합니다.

API가 PEERDIST_ERROR_OUT_OF_BOUNDS 완료되면 겹치는 구조체에 지정된 오프셋이 콘텐츠의 끝을 벗어나는 것을 나타냅니다.

요구 사항

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

추가 정보

PeerDistClientBlockRead

PeerDistClientStreamRead

PeerDistStartup