Partager via


PeerGroupUpdateRecord, fonction (p2p.h)

La fonction PeerGroupUpdateRecord met à jour un enregistrement au sein d’un groupe d’homologues spécifique.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupUpdateRecord(
  [in] HGROUP       hGroup,
  [in] PPEER_RECORD pRecord
);

Paramètres

[in] hGroup

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

[in] pRecord

Pointeur vers une structure PEER_RECORD qui contient l’enregistrement mis à jour pour hGroup. Ce paramètre est obligatoire.

Les membres suivants dans PEER_RECORD peuvent être mis à jour.

  • pwzAttributes
  • ftExpiration
  • data
Les membres suivants dans PEER_RECORD doivent être présents, mais ne peuvent pas être modifiés.
  • dwSize
  • id
  • type
  • dwFlags
Les membres suivants sont ignorés s’ils sont renseignés.
  • dwVersion
  • pwzCreatorId
  • pwzModifiedById
  • ftCreation
  • ftLastModified
  • securityData
Les membres qui restent sont facultatifs.

Valeur retournée

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

Code de retour Description
E_INVALIDARG
L’un des paramètres spécifiés n’est pas valide.
PEER_E_GROUP_NOT_READY
Le groupe d’homologues n’est pas dans un état où un enregistrement peut être mis à jour, par exemple, PeerGroupJoin a été appelé, mais la synchronisation avec la base de données du groupe d’homologues n’est pas terminée.
PEER_E_INVALID_GROUP
Le handle du groupe d’homologues n’est pas valide.
PEER_E_NOT_AUTHORIZED
L’identité d’homologue actuelle n’a pas l’autorisation de supprimer l’enregistrement. Dans ce cas, l’identité d’homologue n’est pas le créateur de l’enregistrement.
PEER_E_RECORD_NOT_FOUND
L’enregistrement ne peut pas se trouver dans le magasin de données.
 

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.

Spécifications

   
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

PeerGroupAddRecord

PeerGroupCreate

PeerGroupDeleteRecord

PeerGroupJoin

PeerGroupOpen