PeerGroupAddRecord, fonction (p2p.h)

Article
03/01/2024

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

Partager via