PeerGroupAddRecord-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGroupAddRecord-Funktion fügt der Peergruppe einen neuen Datensatz hinzu, der an alle teilnehmenden Peers weitergegeben wird.

Syntax

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

Parameter

[in] hGroup

Handle an die Peergruppe. 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 der in hGroup angegebenen Peergruppe hinzugefügt wird. Dieser Parameter ist erforderlich.

Die folgenden Member in PEER_RECORD müssen aufgefüllt werden.

dwSize
type
ftExpiration

ftExpiration muss als Peerzeit ausgedrückt werden (siehe PeerGroupUniversalTimeToPeerTime).

Die folgenden Member werden ignoriert und überschrieben, wenn sie aufgefüllt werden.

id
pwzCreatorId
pwzLastModifiedById
ftCreation
ftLastModified
securityData

Die verbleibenden Felder sind optional.

[out] pRecordId

Zeiger auf eine GUID, die den Datensatz identifiziert. Dieser Parameter ist erforderlich.

Rückgabewert

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

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_GROUP_NOT_READY	Die Peergruppe befindet sich nicht in einem Zustand, in dem Datensätze hinzugefügt werden können. Beispielsweise wird PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Peergruppendatenbank wurde noch nicht abgeschlossen.
PEER_E_INVALID_ATTRIBUTES	Die XML-Zeichenfolge, die die Datensatzattribute im pwzAttributes-Member der PEER_RECORD-Struktur enthält, entspricht nicht der Schemaspezifikation.
PEER_E_INVALID_GROUP	Das Handle für die Peergruppe ist ungültig.
PEER_E_INVALID_PEER_NAME	Der angegebene Peername ist ungültig.
PEER_E_INVALID_RECORD	Mindestens ein Feld in PEER_RECORD ist ungültig.
PEER_E_MAX_RECORD_SIZE_EXCEEDED	Der Datensatz hat die maximale Größe überschritten, die von den Peergruppeneigenschaften zulässig ist.
PEER_E_NOT_AUTHORIZED	Die Identität ist nicht autorisiert, einen Datensatz dieses Typs zu veröffentlichen.

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

Anforderungen

Anforderung	Wert
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

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupUpdateRecord

Freigeben über