PeerGroupAddRecord 関数 (p2p.h)

PeerGroupAddRecord 関数は、ピアグループに新しいレコードを追加します。このレコードは、参加しているすべてのピアに伝達されます。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupAddRecord(
  [in]  HGROUP       hGroup,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

[in] hGroup

ピアグループを処理します。このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。このパラメーターは必須です。

[in] pRecord

hGroupで指定されたピアグループに追加されるPEER_RECORD構造体へのポインター。このパラメーターは必須です。

PEER_RECORDの次のメンバーを設定する必要があります。

ftExpiration はピア時間として表す必要があります ( 「PeerGroupUniversalTimeToPeerTime」を参照)。

次のメンバーは無視され、設定された場合は上書きされます。

残りのフィールドは省略可能です。

[out] pRecordId

レコードを識別する GUID へのポインター。このパラメーターは必須です。

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

リターンコード	説明
E_INVALIDARG	パラメーターの 1 つが無効です。
E_OUTOFMEMORY	指定した操作を実行するのに十分なメモリがありません。
PEER_E_GROUP_NOT_READY	ピアグループは、レコードを追加できる状態ではありません。たとえば、 PeerGroupJoin が呼び出されますが、ピアグループデータベースとの同期は完了していません。
PEER_E_INVALID_ATTRIBUTES	PEER_RECORD構造体の pwzAttributes メンバーのレコード属性を含む XML 文字列は、スキーマの仕様に準拠していません。
PEER_E_INVALID_GROUP	ピアグループへのハンドルが無効です。
PEER_E_INVALID_PEER_NAME	指定されたピア名が無効です。
PEER_E_INVALID_RECORD	PEER_RECORD内の 1 つ以上のフィールドが無効です。
PEER_E_MAX_RECORD_SIZE_EXCEEDED	レコードがピアグループのプロパティで許可されている最大サイズを超えています。
PEER_E_NOT_AUTHORIZED	ID には、その型のレコードを発行する権限がありません。

暗号化固有のエラーは、 Microsoft RSA ベースプロバイダーから返すことができます。これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。

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