PEER_RECORD 構造体 (p2p.h)

[アーティクル]
03/15/2023

PEER_RECORD構造体には、アプリケーションで使用されるレコードオブジェクトが含まれています。

構文

typedef struct peer_record_tag {
  DWORD     dwSize;
  GUID      type;
  GUID      id;
  DWORD     dwVersion;
  DWORD     dwFlags;
  PWSTR     pwzCreatorId;
  PWSTR     pwzModifiedById;
  PWSTR     pwzAttributes;
  FILETIME  ftCreation;
  FILETIME  ftExpiration;
  FILETIME  ftLastModified;
  PEER_DATA securityData;
  PEER_DATA data;
} PEER_RECORD, *PPEER_RECORD;

メンバー

dwSize

構造体のサイズを指定します。値を sizeof(PEER_RECORD) に設定します。

type

レコードの種類を指定します。型は、アプリケーションで指定する必要がある GUID です 。 GUID は、チャットレコードなどの一意のレコードの種類を表します。

id

レコードの一意の ID を指定します。ピアインフラストラクチャは、この ID を提供します。 PeerGroupAddRecord の呼び出しでは、このパラメーターは無視されます。アプリケーションはこのメンバーを変更できません。

dwVersion

アプリケーションが PeerGraphAddRecord または PeerGraphUpdateRecord を呼び出すときにピアインフラストラクチャが提供するレコードのバージョンを指定します。アプリケーションはこのメンバーを変更できません。

dwFlags

レコードに適用する必要がある特殊な処理を示すフラグを指定します。次の表に、有効な値を示します。

値	説明
PEER_RECORD_FLAG_AUTOREFRESH	レコードが期限切れになる準備ができたら自動的に更新されることを示します。
PEER_RECORD_FLAG_DELETED	レコードが削除済みとしてマークされていることを示します。

メモアプリケーションでこれらのフラグを設定することはできません。

pwzCreatorId

レコード作成者の一意の ID へのポインター。 PeerGraphAddRecord および PeerGraphUpdateRecord の呼び出しでは、このメンバーは NULL に設定されます。アプリケーションでこのメンバーを設定することはできません。

pwzModifiedById

レコードを最後に変更したユーザーの一意の ID を指定します。アプリケーションでこのメンバーを設定することはできません。

pwzAttributes

レコードに関連付けられている属性名と値のペアのセットへのポインター。このメンバーは XML 文字列を指します。レコード属性は XML 文字列として指定され、ピアインフラストラクチャレコード属性スキーマと一致している必要があります。 XML スキーマの詳細については、「レコード属性スキーマ」を参照してください。

ピアインフラストラクチャは、ユーザーが設定できない複数の属性名を予約します。次の一覧は、予約済みの属性名を示しています。

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
peercreationtime
peerlastmodificationtime

ftCreation

レコードが作成される協定世界時 (UTC) を指定します。ピアインフラストラクチャはこの値を提供し、 PeerGroupAddRecord の呼び出しでは値が 0 に設定されます。アプリケーションでこのメンバーを設定することはできません。

ftExpiration

レコードの有効期限が切れる UTC 時刻。このメンバーは必須です。最初に指定した時刻値より大きい時間値に更新できますが、元に指定した値より小さくすることはできません。

メモdwFlags が PEER_RECORD_FLAG_AUTOREFRESH に設定されている場合は、ftExpiration の値を 4 分未満に設定しないでください。このメンバーが 4 分未満に設定されている場合、未定義の動作が発生する可能性があります。

ftLastModified

レコードが変更された UTC 時刻。ピアインフラストラクチャは、この値を提供します。 PeerGraphAddRecord、PeerGraphUpdateRecord、PeerGroupAddRecord、PeerGroupUpdateRecord を呼び出すときに、このメンバーを NULL に設定します。アプリケーションでこのメンバーを設定することはできません。

securityData

PEER_DATA構造体に含まれるセキュリティデータを指定します。 Graphing API はこのメンバーを使用し、セキュリティプロバイダーにセキュリティデータ (署名など) を格納する場所を提供します。グループ化 API では、このメンバーを変更できません。

data

このレコードに含まれる実際のデータを指定します。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2 [デスクトップアプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー	サポートなし
Header	p2p.h