PeerDistServerOpenContentInformation 함수(peerdist.h)

  • 아티클

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

구문

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

매개 변수

[in] hPeerDist

PeerDistStartup에서 반환된 PEERDIST_INSTANCE_HANDLE.

cbContentIdentifier

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

[in] pContentIdentifier

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

ullContentOffset

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

cbContentLength

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

[in, optional] hCompletionPort

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

[in, optional] ulCompletionKey

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

[out] phContentInfo

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

반환 값

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

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

설명

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

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

요구 사항

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

추가 정보

PeerDistServerRetrieveContentInformation