PeerDistServerPublishStream 関数 (peerdist.h)

[アーティクル]
03/01/2024

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	1 つ以上のパラメーターが無効です。
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
Library	PeerDist.lib
[DLL]	PeerDist.dll