PEER_RECORD 結構 (p2p.h)

發行項
03/01/2024

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

指定記錄的唯一識別碼。對等基礎結構會提供此標識碼。對 PeerGroupAddRecord 的呼叫中會忽略此參數。應用程式無法修改此成員。

dwVersion

指定當應用程式呼叫 PeerGraphAddRecord 或 PeerGraphUpdateRecord 時，對等基礎結構所提供的記錄版本。應用程式無法修改此成員。

dwFlags

指定指出特殊處理的旗標，這些旗標必須套用至記錄。下表識別有效值。

值	Description
PEER_RECORD_FLAG_AUTOREFRESH	指出記錄在準備好到期時會自動重新整理。
PEER_RECORD_FLAG_DELETED	表示記錄標示為已刪除。

注意應用程式無法設定這些旗標。

pwzCreatorId

記錄建立者的唯一標識符指標。此成員會設定為 NULL ，以呼叫 PeerGraphAddRecord 和 PeerGraphUpdateRecord。應用程式無法設定此成員。

pwzModifiedById

指定變更記錄的最後一個人的唯一標識符。應用程式無法設定此成員。

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) 分鐘。如果此成員設定為小於 4 (4) 分鐘，則可能發生未定義的行為。

ftLastModified

修改記錄的 UTC 時間。對等基礎結構提供此值。呼叫 PeerGraphAddRecord、PeerGraphUpdateRecord、PeerGroupAddRecord 和 PeerGroupUpdateRecord 時，將此成員設定為 NULL。應用程式無法設定此成員。

securityData

指定 PEER_DATA 結構中包含的安全性數據。圖形 API 會使用此成員，並提供安全性提供者來儲存安全性數據的位置，例如簽章。群組 API 無法修改此成員。

data

指定此記錄包含的實際數據。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件
最低支援的伺服器	都不支援
標頭	p2p.h