PeerGraphAddRecord, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGraphAddRecord ajoute un nouvel enregistrement à un graphique homologue. Un enregistrement ajouté avec cette fonction est envoyé à chaque nœud dans un graphique homologue.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Paramètres

[in] hGraph

Gérer vers un graphe d’homologue.

[in] pRecord

Pointeur vers un enregistrement à ajouter.

[out] pRecordId

Spécifie l’ID d’enregistrement qui identifie de manière unique un enregistrement dans un graphique homologue.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.

Code de retour	Description
E_ACCESSDENIED	Impossible d’accéder à un graphique homologue.
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer une opération spécifiée.
PEER_E_GRAPH_NOT_READY	Un graphique n’est pas synchronisé. Les enregistrements ne peuvent pas être ajoutés tant que le graphe homologue n’est pas synchronisé.
PEER_E_GRAPH_SHUTTING_DOWN	PeerGraphClose a été appelé.
PEER_E_INVALID_ATTRIBUTES	Les attributs spécifiés ne correspondent pas au schéma.
PEER_E_INVALID_GRAPH	Le handle d’un graphe d’homologue n’est pas valide.
PEER_E_MAX_RECORD_SIZE_EXCEEDED	L’enregistrement dépasse la taille maximale autorisée par un graphe homologue.
PEER_E_NOT_INITIALIZED	Le graphe doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

Les membres suivants de la structure PEER_RECORD doivent contenir des valeurs valides :

dwSize.
type.
ftExpiration : doit être postérieure à l’heure actuelle du graphique et doit être spécifiée dans l’heure d’homologue à l’aide de PeerGraphUniversalTimeToPeerTime.

Les membres suivants de la structure PEER_RECORD sont facultatifs. Définissez-les sur NULL s’ils ne sont pas utilisés par votre application :

data
pwzAttributes
securityData
dwVersion

Si l’un des membres suivants a la valeur NULL, l’API Peer Graphing exécute le comportement par défaut spécifié :

pwzCreatorId : utilise l’ID d’homologue passé à PeerGraphCreate ou PeerGraphOpen.
pwzModifiedById : utilise le pwzCreatorId.

Les membres suivants ne peuvent pas être spécifiés ; toute valeur utilisée est remplacée par l’infrastructure Peer Graphing :

id.
ftCreation : utilise l’heure d’homologue.
ftLastModified : utilise l’heure d’homologue.

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
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2PGraph.lib
DLL	P2PGraph.dll

Voir aussi

PEER_RECORD

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate

Partager via