PeerGroupAddRecord, fonction (p2p.h)

  • Article

La fonction PeerGroupAddRecord ajoute un nouvel enregistrement au groupe d’homologues, qui est propagé à tous les homologues participants.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupAddRecord(
  [in]  HGROUP       hGroup,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Paramètres

[in] hGroup

Gérez le groupe d’homologues. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pRecord

Pointeur vers une structure PEER_RECORD ajoutée au groupe d’homologues spécifié dans hGroup. Ce paramètre est obligatoire.

Les membres suivants dans PEER_RECORD doivent être renseignés.

  • dwSize
  • type
  • ftExpiration
ftExpiration doit être exprimé en tant que temps d’homologue (voir PeerGroupUniversalTimeToPeerTime).

Les membres suivants sont ignorés et remplacés s’ils sont renseignés.

  • id
  • pwzCreatorId
  • pwzLastModifiedById
  • ftCreation
  • ftLastModified
  • securityData
Les champs restants sont facultatifs.

[out] pRecordId

Pointeur vers un GUID qui identifie l’enregistrement. Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si la fonction réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour Description
E_INVALIDARG
 L’un des paramètres n’est pas valide.
E_OUTOFMEMORY
 La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_GROUP_NOT_READY
 Le groupe d’homologues n’est pas dans un état où des enregistrements peuvent être ajoutés. Par exemple, PeerGroupJoin est appelé, mais la synchronisation avec la base de données de groupe d’homologues n’est pas terminée.
PEER_E_INVALID_ATTRIBUTES
 La chaîne XML qui contient les attributs d’enregistrement dans le membre pwzAttributes de la structure PEER_RECORD n’est pas conforme à la spécification de schéma.
PEER_E_INVALID_GROUP
 Le handle du groupe d’homologues n’est pas valide.
PEER_E_INVALID_PEER_NAME
 Le nom d’homologue fourni n’est pas valide.
PEER_E_INVALID_RECORD
 Un ou plusieurs champs dans PEER_RECORD ne sont pas valides.
PEER_E_MAX_RECORD_SIZE_EXCEEDED
 L’enregistrement a dépassé la taille maximale autorisée par les propriétés du groupe d’homologues.
PEER_E_NOT_AUTHORIZED
 L’identité n’est pas autorisée à publier un enregistrement de ce type.
 

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont précédées de CRYPT_* et définies dans Winerror.h.

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 P2P.lib
DLL P2P.dll

Voir aussi

PEER_RECORD

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupUpdateRecord