次の方法で共有

PeerDistServerRetrieveContentInformation 関数 (peerdist.h)

  • [アーティクル]

PeerDistServerRetrieveContentInformation 関数は、PeerDistServerOpenContentInformation によって返されるハンドルに関連付けられたエンコードされたコンテンツ情報を取得します。

構文

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

パラメーター

[in] hPeerDist

PeerDistStartup によって返されるPEERDIST_INSTANCE_HANDLE。

[in] hContentInfo

PeerDistServerOpenContentInformation によって返されるハンドル。

cbMaxNumberOfBytes

読み取る最大バイト数。

[in, out] pBuffer

コンテンツ情報データを受け取るバッファーへのポインター。

[in] lpOverlapped

OVERLAPPED 構造体へのポインター。 この関数では、呼び出し元がコンテンツの開始オフセットを指定することはできません。 オフセットは、hContentInfo ごとに暗黙的に維持されます。 Offset と OffsetHigh は予約済みであり、0 である必要があります。

戻り値

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

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

注釈

PeerDistServerRetrieveContentInformation 操作が成功すると、OVERLAPPED 構造体の Offset フィールドと OffsetHigh フィールドに、取得されたコンテンツ情報の ULONGLONG オフセットが設定されます。 OffsetHigh メンバーはオフセットの上位 32 ビットに設定され、Offset メンバーはオフセットの下位 32 ビットに設定されます。

GetOverlappedResult は、 lpNumberOfBytesTransferred に 転送されたバイト数を設定します。 呼び出し元が完了ポートを使用してピア分散 API の入力候補を処理している場合、GetQueuedCompletionStatus の lpNumberOfBytes 引数には、転送されたバイト数が設定されます。

要件

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

こちらもご覧ください

PeerDistServerOpenContentInformation

PeerDistStartup