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. 그렇지 않은 경우에는 함수가 다음 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
하나 이상의 매개 변수가 잘못되었습니다. |
|
hPeerDist 핸들이 잘못되었습니다. |
|
지정된 콘텐츠 식별자 데이터가 게시되지 않습니다. |
|
이 기능은 그룹 정책 사용하지 않도록 설정됩니다. |
|
서비스를 사용할 수 없습니다. |
설명
함수가 성공하면 phContentInfo 에서 받은 핸들을 에 전달할 수 있습니다.
콘텐츠 정보를 검색하는 PeerDistServerRetrieveContentInformation 함수입니다.
PeerDistServerCloseContentInformation 함수를 통해 핸들을 닫아야 합니다.
ullContentOffset 및 cbContentLength가 모두 0이면 전체 콘텐츠에 대한 콘텐츠 정보가 검색됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | peerdist.h |
| 라이브러리 | PeerDist.lib |
| DLL | PeerDist.dll |