structure PEER_RECORD (p2p.h)

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 peer 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 doit être appliqué à 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’enregistrements. Ce membre est défini sur 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 et valeur d’attribut qui sont associées à un enregistrement. Ce membre pointe vers une chaîne XML. Les attributs d’enregistrement sont spécifiés en tant que chaîne XML et doivent être cohérents avec le schéma d’attribut d’enregistrement d’infrastructure homologue. Pour obtenir une explication complète du schéma XML, consultez Le schéma d’attribut d’enregistrement.

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 d’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 requis. Elle peut être mise à jour vers une valeur de temps 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 a la valeur inférieure à quatre (4) minutes, le comportement non défini peut se produire.
 

ftLastModified

Heure UTC modifiée 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

   
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec advanced networking Pack forWindows XP
Serveur minimal pris en charge Aucun pris en charge
En-tête p2p.h

Voir aussi

PEER_DATA

PFNPEER_SECURE_RECORD

PFNPEER_VALIDATE_RECORD

PeerGraphAddRecord

PeerGraphDeleteRecord

PeerGraphGetRecord

PeerGraphUpdateRecord

PeerGroupAddRecord

PeerGroupDeleteRecord

PeerGroupGetRecord

PeerGroupUpdateRecord