PeerGroupUpdateRecord-Funktion (p2p.h)

  • Artikel

Die Funktion PeerGroupUpdateRecord aktualisiert einen Datensatz innerhalb einer bestimmten Peergruppe.

Syntax

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

Parameter

[in] hGroup

Handle an die Peergruppe, deren Datensatz aktualisiert wird. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pRecord

Zeiger auf eine PEER_RECORD-Struktur , die den aktualisierten Datensatz für hGroup enthält. Dieser Parameter ist erforderlich.

Die folgenden Member in PEER_RECORD können aktualisiert werden.

  • pwzAttributes
  • ftExpiration
  • data
Die folgenden Member in PEER_RECORD müssen vorhanden sein, können aber nicht geändert werden.
  • dwSize
  • id
  • type
  • dwFlags
Die folgenden Member werden ignoriert, wenn sie aufgefüllt werden.
  • dwVersion
  • pwzCreatorId
  • pwzModifiedById
  • ftCreation
  • ftLastModified
  • securityData
Die verbleibenden Member sind optional.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode Beschreibung
E_INVALIDARG
 Einer der angegebenen Parameter ist ungültig.
PEER_E_GROUP_NOT_READY
 Die Peergruppe befindet sich nicht in einem Zustand, in dem ein Datensatz aktualisiert werden kann, z. B. wurde PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Peergruppendatenbank ist nicht abgeschlossen.
PEER_E_INVALID_GROUP
 Das Handle für die Peergruppe ist ungültig.
PEER_E_NOT_AUTHORIZED
 Die aktuelle Peeridentität verfügt nicht über die Berechtigung zum Löschen des Datensatzes. In diesem Fall ist die Peeridentität nicht der Ersteller des Datensatzes.
PEER_E_RECORD_NOT_FOUND
 Der Datensatz kann nicht im Datenspeicher gefunden werden.
 

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Erweiterten Netzwerkpaket fürWindows XP
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile p2p.h
Bibliothek P2P.lib
DLL P2P.dll

Weitere Informationen

PEER_RECORD

PeerGroupAddRecord

PeerGroupErstellen

PeerGroupDeleteRecord

PeerGroupJoin

PeerGroupOpen