次の方法で共有

PeerDistClientAddContentInformation 関数 (peerdist.h)

  • [アーティクル]

PeerDistClientAddContentInformation 関数は、PeerDistClientOpenContent によって開かれたコンテンツ ハンドルに関連付けられたコンテンツ情報を追加します。

構文

DWORD PeerDistClientAddContentInformation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in] PEERDIST_CONTENT_HANDLE  hContentHandle,
       DWORD                    cbNumberOfBytes,
  [in] PBYTE                    pBuffer,
  [in] LPOVERLAPPED             lpOverlapped
);

パラメーター

[in] hPeerDist

PeerDistStartup によって返されるPEERDIST_INSTANCE_HANDLE。

[in] hContentHandle

PeerDistClientOpenContent によって開かれたPEERDIST_CONTENT_HANDLE。

cbNumberOfBytes

pBuffer 配列内のバイト数。

[in] pBuffer

コンテンツ情報を含むバッファーへのポインター。 このバッファーは、追加操作の間有効なままである必要があります。 呼び出し元は、追加操作が完了するまで、このバッファーを使用しないでください。

[in] lpOverlapped

OVERLAPPED 構造体へのポインター。 OVERLAPPED 構造体の内部メンバーには、非同期操作の完了状態が含まれています。 Offset と OffsetHigh は予約済みであり、0 である必要があります。

戻り値

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

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

注釈

Peer Distribution サービスからコンテンツ データを取得するには、 PeerDistClientAddContentInformation 関数を呼び出して、クライアントがコンテンツ サーバーから受信したコンテンツ情報を追加する必要があります。 すべてのコンテンツ情報データが追加されたら、 PeerDistClientCompleteContentInformation 関数を呼び出す必要があります。 PeerDistClientCompleteContentInformation が完了すると、クライアントは PeerDistClientStreamRead または PeerDistClientBlockRead を呼び出して、ピア配布システムからデータを取得できます。

1 つのコンテンツ ハンドルでこの関数を複数回呼び出す場合、呼び出し元は、次の呼び出しが行われる前に、各操作が完了するまで待機する必要があります。

アプリケーションは、1 つの PeerDistClientAddContentInformation API 呼び出しを使用してコンテンツ情報を追加するだけでなく、そのコンテンツ情報の一部を使用可能にして追加することもできます。 さらに多くのコンテンツ情報が利用可能になると、アプリケーションは PeerDistClientAddContentInformation を再度呼び出すことができます。 アプリケーションでコンテンツ情報全体の追加が完了したら、 PeerDistClientCompleteContentInformation を呼び出す必要があります。

要件

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

こちらもご覧ください

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup