Freigeben über

PeerGroupAddRecord-Funktion (p2p.h)

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

  • Last updated on