PeerDistServerOpenContentInformationEx 함수(peerdist.h)

PeerDistServerOpenContentInformationEx 함수는 PEERDIST_CONTENTINFO_HANDLE 엽니다. 클라이언트는 핸들을 사용하여 콘텐츠 정보를 검색합니다.

Syntax

DWORD PeerDistServerOpenContentInformationEx(
  [in]           PEERDIST_INSTANCE_HANDLE     hPeerDist,
  [in]           DWORD                        cbContentIdentifier,
  [in]           PBYTE                        pContentIdentifier,
                 ULONGLONG                    ullContentOffset,
                 ULONGLONG                    cbContentLength,
  [in]           PEERDIST_RETRIEVAL_OPTIONS   *pRetrievalOptions,
  [in, optional] HANDLE                       hCompletionPort,
  [in, optional] ULONG_PTR                    ulCompletionKey,
  [out]          PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);

매개 변수

[in] hPeerDist

PeerDistStartup에서 반환한 PEERDIST_INSTANCE_HANDLE.

[in] cbContentIdentifier

콘텐츠 식별자의 길이(바이트)입니다.

[in] pContentIdentifier

콘텐츠 식별자를 포함하는 버퍼에 대한 포인터입니다.

ullContentOffset

콘텐츠 정보 핸들이 요청된 게시된 콘텐츠의 시작 부분부터의 오프셋입니다.

cbContentLength

콘텐츠 정보가 요청되는 콘텐츠의 길이(ullContentOffset부터 시작)입니다(바이트).

[in] pRetrievalOptions

콘텐츠 정보를 검색하기 위한 추가 옵션을 지정하는 PEER_RETRIEVAL_OPTIONS 구조체입니다.

[in, optional] hCompletionPort

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

[in, optional] ulCompletionKey

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

[out] phContentInfo

콘텐츠 정보를 검색하는 데 사용되는 핸들입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

비고

함수가 성공하면 phContentInfo 에서 받은 핸들을 다음으로 전달할 수 있습니다.
PeerDistServerRetrieveContentInformation 함수는 콘텐츠 정보를 검색합니다. PeerDistServerCloseContentInformation 함수를 통해 핸들을 닫아야 합니다.

ullContentOffset 및 cbContentLength가 모두 0이면 전체 콘텐츠에 대한 콘텐츠 정보가 검색됩니다.

pRetrievalOptions 매개 변수를 사용하여 요청 클라이언트가 처리하도록 구성된 콘텐츠 정보 버전 범위를 지정할 수 있습니다. 이렇게 하면 클라이언트가 해당 버전의 콘텐츠 정보 구조를 검색할 수 있습니다.

요구 사항

요구 사항	가치
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	윈도우즈
Header	peerdist.h
Library	PeerDist.lib