PeerDistClientOpenContent 함수(peerdist.h)

아티클
08/25/2023

PeerDistClientOpenContent 함수가 열리고 PEERDIST_CONTENT_HANDLE 반환합니다. 클라이언트는 콘텐츠 핸들을 사용하여 피어 배포 서비스에서 데이터를 검색합니다.

구문

DWORD PeerDistClientOpenContent(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PCPEERDIST_CONTENT_TAG   pContentTag,
  [in, optional] HANDLE                   hCompletionPort,
  [in, optional] ULONG_PTR                ulCompletionKey,
  [out]          PPEERDIST_CONTENT_HANDLE phContentHandle
);

매개 변수

[in] hPeerDist

PeerDistStartup에서 반환된 PEERDIST_INSTANCE_HANDLE.

[in] pContentTag

지정된 16 바이트 클라이언트 식별자를 포함하는 PEERDIST_CONTENT_TAG 구조체에 대한 포인터입니다. 이 매개 변수는 PeerDistClientFlushContent 함수와 함께 사용됩니다.

[in, optional] hCompletionPort

비동기 함수의 완료 알림을 검색하는 데 사용할 수 있는 완료 포트에 대한 핸들입니다. 완성 포트를 만들려면 CreateIoCompletionPort 함수 이 매개 변수는 NULL일 수 있습니다.

[in, optional] ulCompletionKey

GetQueuedCompletionStatus 함수의 lpCompletionKey 매개 변수를 통해 반환되는 값입니다. hCompletionPort가 NULL인 경우 이 매개 변수는 무시됩니다.

[out] phContentHandle

데이터를 검색하거나 추가하는 데 사용되는 PEERDIST_CONTENT_HANDLE 수신하는 변수에 대한 포인터입니다.

반환 값

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

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

설명

클라이언트는 PeerDistClientOpenContent 함수를 호출하여 나중에 다음 함수에서 사용할 수 있는 PEERDIST_CONTENT_HANDLE 핸들을 가져와야 합니다.

선택적 완료 포트 핸들을 지정하면 위에 나열된 비동기 함수의 완료 결과를 게시하는 데 사용됩니다.

PeerDistClientOpenContent 함수 호출에서 반환된 핸들은 PeerDistClientCloseContent 함수에 의해 닫혀야 합니다.

요구 사항


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