structure PEER_RECORD (p2p.h)

Article
08/25/2023

La structure PEER_RECORD contient l’objet d’enregistrement utilisé par une application.

Syntaxe

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;

Membres

dwSize

Spécifie la taille d’une structure. Définissez la valeur sur sizeof(PEER_RECORD).

type

Spécifie le type d’enregistrement. Le type est un GUID qu’une application doit spécifier. Le GUID représente un type d’enregistrement unique, par exemple un enregistrement de conversation.

id

Spécifie l’ID unique d’un enregistrement. L’infrastructure homologue fournit cet ID. Ce paramètre est ignoré dans les appels à PeerGroupAddRecord. Une application ne peut pas modifier ce membre.

dwVersion

Spécifie la version d’un enregistrement que l’infrastructure d’homologue fournit lorsqu’une application appelle PeerGraphAddRecord ou PeerGraphUpdateRecord. Une application ne peut pas modifier ce membre.

dwFlags

Spécifie les indicateurs qui indiquent un traitement spécial, qui doivent être appliqués à un enregistrement. Le tableau suivant identifie les valeurs valides.

Valeur	Description
PEER_RECORD_FLAG_AUTOREFRESH	Indique qu’un enregistrement est automatiquement actualisé lorsqu’il est prêt à expirer.
PEER_RECORD_FLAG_DELETED	Indique qu’un enregistrement est marqué comme supprimé.

Note Une application ne peut pas définir ces indicateurs.

pwzCreatorId

Pointeur vers l’ID unique d’un créateur d’enregistrement. Ce membre a la valeur NULL pour les appels à PeerGraphAddRecord et PeerGraphUpdateRecord. Une application ne peut pas définir ce membre.

pwzModifiedById

Spécifie l’ID unique de la dernière personne qui modifie un enregistrement. Une application ne peut pas définir ce membre.

pwzAttributes

Pointeur vers l’ensemble de paires nom d’attribut et valeur associées à un enregistrement. Ce membre pointe vers une chaîne XML. Les attributs d’enregistrement sont spécifiés sous forme de chaîne XML et doivent être cohérents avec le schéma d’attribut d’enregistrement d’infrastructure d’homologue. Pour obtenir une explication complète du schéma XML, consultez Record Attribute Schema.

L’infrastructure d’homologue réserve plusieurs noms d’attributs qu’un utilisateur ne peut pas définir. La liste suivante identifie les noms d’attributs réservés :

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
peercreationtime
peerlastmodificationtime

ftCreation

Spécifie le temps universel coordonné (UTC) qu’un enregistrement est créé. L’infrastructure homologue fournit cette valeur, et la valeur est définie sur zéro (0) dans les appels à PeerGroupAddRecord. Une application ne peut pas définir ce membre.

ftExpiration

Heure UTC d’expiration d’un enregistrement. Ce membre est obligatoire. Il peut être mis à jour vers une valeur d’heure supérieure à la valeur de temps spécifiée à l’origine, mais elle ne peut pas être inférieure à la valeur spécifiée à l’origine.

Note Si dwFlags est défini sur PEER_RECORD_FLAG_AUTOREFRESH, ne définissez pas la valeur de ftExpiration sur moins de quatre (4) minutes. Si ce membre est défini sur moins de quatre (4) minutes, un comportement non défini peut se produire.

ftLastModified

Heure UTC de modification d’un enregistrement. L’infrastructure homologue fournit cette valeur. Définissez ce membre sur NULL lors de l’appel de PeerGraphAddRecord, PeerGraphUpdateRecord, PeerGroupAddRecord et PeerGroupUpdateRecord. Une application ne peut pas définir ce membre.

securityData

Spécifie les données de sécurité contenues dans une structure de PEER_DATA . L’API Graphing utilise ce membre et fournit au fournisseur de sécurité un emplacement pour stocker des données de sécurité, par exemple une signature. L’API de regroupement ne peut pas modifier ce membre.

data

Spécifie les données réelles que cet enregistrement contient.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows XP
Serveur minimal pris en charge	Aucun pris en charge
En-tête	p2p.h