PeerGroupUpdateRecord, fonction (p2p.h)

Article
08/25/2023

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