PeerDistServerPublishStream 함수(peerdist.h)

아티클
03/15/2023

PeerDistServerPublishStream 함수는 피어 배포 서비스에 게시할 새 스트림을 초기화합니다.

구문

DWORD PeerDistServerPublishStream(
  [in]           PEERDIST_INSTANCE_HANDLE       hPeerDist,
                 DWORD                          cbContentIdentifier,
  [in]           PBYTE                          pContentIdentifier,
                 ULONGLONG                      cbContentLength,
  [in, optional] PCPEERDIST_PUBLICATION_OPTIONS pPublishOptions,
  [in, optional] HANDLE                         hCompletionPort,
  [in, optional] ULONG_PTR                      ulCompletionKey,
  [out]          PPEERDIST_STREAM_HANDLE        phStream
);

매개 변수

[in] hPeerDist

PeerDistStartup에서 반환된 PEERDIST_INSTANCE_HANDLE.

cbContentIdentifier

콘텐츠 식별자 데이터가 포함된 버퍼의 길이(바이트)입니다.

[in] pContentIdentifier

콘텐츠 식별자 데이터가 포함된 배열에 대한 포인터입니다.

cbContentLength

게시할 콘텐츠의 길이(바이트)입니다. 콘텐츠 길이를 아직 알 수 없는 경우 이 값은 0일 수 있습니다. 0이 아닌 인수가 제공되면 PeerDistServerPublishAddToStream 함수 호출에서 추가한 총 데이터 길이와 일치해야 합니다.

[in, optional] pPublishOptions

콘텐츠 게시 규칙을 지정하는 PEERDIST_PUBLICATION_OPTIONS 구조체에 대한 포인터입니다.

[in, optional] hCompletionPort

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

[in, optional] ulCompletionKey

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

[out] phStream

피어 배포 서비스에 데이터를 게시하는 데 사용되는 스트림에 대한 핸들을 수신하는 포인터입니다.

반환 값

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

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

설명

콘텐츠 식별자는 게시되는 콘텐츠에 대한 사용자 정의 레이블입니다. 이 콘텐츠 식별자는 PeerDistServerOpenContentInformation, PeerDistServerUnpublish 및 PeerDistServerCancelAsyncOperation 호출에 사용됩니다.

phStream에서 받은 핸들은 PeerDistServerPublishAddToStream 및 PeerDistServerPublishCompleteStream 에서 사용하여 피어 배포 서비스에 데이터를 게시할 수 있습니다. 이 핸들은 PeerDistServerCloseStreamHandle에 의해 닫혀야 합니다.

게시는 원래 콘텐츠를 게시한 사용자 계정에서만 액세스할 수 있습니다. 다른 사용자가 동일한 콘텐츠 식별자를 사용하여 PeerDistServerPublishStream 을 호출하는 경우 해당 사용자의 컨텍스트에서 별도의 게시가 만들어집니다.

요구 사항

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