PeerGraphAddRecord 関数 (p2p.h)

PeerGraphAddRecord 関数は、ピアグラフに新しいレコードを追加します。この関数で追加されたレコードは、ピアグラフ内の各ノードに送信されます。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

[in] hGraph

ピアグラフへのハンドル。

[in] pRecord

追加するレコードへのポインター。

[out] pRecordId

ピアグラフ内のレコードを一意に識別するレコード ID を指定します。

関数呼び出しが成功した場合、戻り値は S_OK。それ以外の場合は、次のいずれかの値を返します。

リターンコード	説明
E_ACCESSDENIED	ピアグラフにアクセスできません。
E_INVALIDARG	パラメーターの 1 つが無効です。
E_OUTOFMEMORY	指定した操作を実行するのに十分なメモリがありません。
PEER_E_GRAPH_NOT_READY	グラフは同期されません。ピアグラフが同期されるまで、レコードを追加することはできません。
PEER_E_GRAPH_SHUTTING_DOWN	PeerGraphClose が呼び出されました。
PEER_E_INVALID_ATTRIBUTES	指定した属性がスキーマと一致しません。
PEER_E_INVALID_GRAPH	ピアグラフへのハンドルが無効です。
PEER_E_MAX_RECORD_SIZE_EXCEEDED	レコードがピアグラフで許可されている最大サイズを超えています。
PEER_E_NOT_INITIALIZED	この関数を使用する前に、 PeerGraphStartup の呼び出しでグラフを初期化する必要があります。

PEER_RECORD 構造体の次のメンバーには、有効な値が含まれている必要があります。

dwSize。
type。
ftExpiration - 現在のグラフ時刻より後にする必要があり、 PeerGraphUniversalTimeToPeerTime を使用してピア時間で指定する必要があります。

PEER_RECORD構造体の次のメンバーは省略可能です。アプリケーションで使用されていない場合は 、NULL に設定します。

次のいずれかのメンバーが NULL の場合、Peer Graphing API は指定された既定の動作を実行します。

次のメンバーは指定できません。使用されるすべての値は、ピアグラフインフラストラクチャによって上書きされます。

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2 [デスクトップアプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	p2p.h
Library	P2PGraph.lib
[DLL]	P2PGraph.dll