다음을 통해 공유

PeerDistClientAddContentInformation 함수(peerdist.h)

  • 아티클

PeerDistClientAddContentInformation 함수는 PeerDistClientOpenContent에서 연 콘텐츠 핸들과 연결된 콘텐츠 정보를 추가합니다.

구문

DWORD PeerDistClientAddContentInformation(
  [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

pBuffer 배열의 바이트 수입니다.

[in] pBuffer

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

[in] lpOverlapped

OVERLAPPED 구조체에 대한 포인터입니다. OVERLAPPED 구조체의 내부 멤버에는 비동기 작업의 완료 상태 포함됩니다. Offset 및 OffsetHigh는 예약되어 있으며 0이어야 합니다.

반환 값

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

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

설명

피어 배포 서비스에서 콘텐츠 데이터를 검색하려면 클라이언트가 PeerDistClientAddContentInformation 함수를 호출하여 콘텐츠 서버에서 받은 콘텐츠 정보를 추가해야 합니다. 모든 콘텐츠 정보 데이터가 추가되면 PeerDistClientCompleteContentInformation 함수를 호출해야 합니다. PeerDistClientCompleteContentInformation이 완료되면 클라이언트는 PeerDistClientStreamRead 또는 PeerDistClientBlockRead를 호출하여 피어 배포 시스템에서 데이터를 검색할 수 있습니다.

단일 콘텐츠 핸들에서 이 함수를 여러 번 호출하는 경우 호출자는 다음 호출이 수행되기 전에 각 작업이 완료되기를 기다려야 합니다.

애플리케이션은 단일 PeerDistClientAddContentInformation API 호출을 사용하여 콘텐츠 정보를 추가하는 것으로 제한되지 않습니다. 해당 콘텐츠 정보의 일부를 사용할 수 있게 되므로 추가할 수 있습니다. 더 많은 콘텐츠 정보를 사용할 수 있는 경우 애플리케이션은 PeerDistClientAddContentInformation을 다시 호출할 수 있습니다. 애플리케이션이 전체 콘텐츠 정보를 추가하면 PeerDistClientCompleteContentInformation을 호출해야 합니다.

요구 사항

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

추가 정보

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup