次の方法で共有

PeerDistClientOpenContent 関数 (peerdist.h)

  • [アーティクル]

PeerDistClientOpenContent 関数が開き、PEERDIST_CONTENT_HANDLEが返されます。 クライアントは、コンテンツ ハンドルを使用してピア配布サービスからデータを取得します。

構文

DWORD PeerDistClientOpenContent(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PCPEERDIST_CONTENT_TAG   pContentTag,
  [in, optional] HANDLE                   hCompletionPort,
  [in, optional] ULONG_PTR                ulCompletionKey,
  [out]          PPEERDIST_CONTENT_HANDLE phContentHandle
);

パラメーター

[in] hPeerDist

PeerDistStartup によって返されるPEERDIST_INSTANCE_HANDLE。

[in] pContentTag

16 バイトのクライアント 指定識別子を含むPEERDIST_CONTENT_TAG構造体へのポインター。 このパラメーターは、 PeerDistClientFlushContent 関数と組み合わせて使用されます。

[in, optional] hCompletionPort

非同期関数の完了通知を取得するために使用できる完了ポートへのハンドル。 完了ポートを作成するには、 CreateIoCompletionPort 関数を使用します。このパラメーターは NULL にすることができます。

[in, optional] ulCompletionKey

GetQueuedCompletionStatus 関数の lpCompletionKey パラメーターを介して返される値。 hCompletionPort が NULL の場合、このパラメーターは無視されます。

[out] phContentHandle

データの取得または追加に使用される PEERDIST_CONTENT_HANDLE を受け取る変数へのポインター。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。 それ以外の場合は、関数から次の値のいずれかが返されます。

リターン コード 説明
ERROR_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。
ERROR_INVALID_HANDLE
 hPeerDist ハンドルが無効です。
ERROR_ACCESS_DISABLED_BY_POLICY
 この機能は、グループ ポリシーによって無効になっています。
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 サービスを利用できません。

解説

クライアントは PeerDistClientOpenContent 関数を呼び出して、後で次の関数で使用できる PEERDIST_CONTENT_HANDLE ハンドルを取得する必要があります。

省略可能な入力候補ポート ハンドルを指定した場合は、上記の非同期関数の完了結果を投稿するために使用されます。

PeerDistClientOpenContent 関数呼び出しによって返されるハンドルは、PeerDistClientCloseContent 関数で閉じる必要があります。

要件

   
サポートされている最小のクライアント Windows 7 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー peerdist.h
Library PeerDist.lib
[DLL] PeerDist.dll

関連項目

PeerDistClientAddContentInformation

PeerDistClientAddData

PeerDistClientBlockRead

PeerDistClientCloseContent

PeerDistClientCompleteContentInformation

PeerDistClientFlushContent

PeerDistClientStreamRead

PeerDistStartup