PeerGraphAddRecord-Funktion (p2p.h)

  • Artikel

Die Funktion PeerGraphAddRecord fügt einem Peerdiagramm einen neuen Datensatz hinzu. Ein mit dieser Funktion hinzugefügter Datensatz wird an jeden Knoten in einem Peerdiagramm gesendet.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Parameter

[in] hGraph

Handle mit einem Peerdiagramm.

[in] pRecord

Zeiger auf einen hinzuzufügenden Datensatz.

[out] pRecordId

Gibt die Datensatz-ID an, die einen Datensatz in einem Peerdiagramm eindeutig identifiziert.

Rückgabewert

Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode Beschreibung
E_ACCESSDENIED
 Auf ein Peerdiagramm kann nicht zugegriffen werden.
E_INVALIDARG
 Einer der Parameter ist ungültig.
E_OUTOFMEMORY
 Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen.
PEER_E_GRAPH_NOT_READY
 Ein Diagramm wird nicht synchronisiert. Datensätze können erst hinzugefügt werden, wenn das Peerdiagramm synchronisiert ist.
PEER_E_GRAPH_SHUTTING_DOWN

PeerGraphClose wurde aufgerufen.
PEER_E_INVALID_ATTRIBUTES
 Die angegebenen Attribute stimmen nicht mit dem Schema überein.
PEER_E_INVALID_GRAPH
 Das Handle für ein Peerdiagramm ist ungültig.
PEER_E_MAX_RECORD_SIZE_EXCEEDED
 Der Datensatz überschreitet die maximal zulässige Größe eines Peerdiagramms.
PEER_E_NOT_INITIALIZED
 Das Diagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

Hinweise

Die folgenden Member der PEER_RECORD-Struktur müssen gültige Werte enthalten:

  • dwSize.
  • geben Sie ein.
  • ftExpiration : Muss höher als die aktuelle Graphzeit sein und muss in der Peerzeit mithilfe von PeerGraphUniversalTimeToPeerTime angegeben werden.
Die folgenden Elemente der PEER_RECORD-Struktur sind optional. Legen Sie sie auf NULL fest, wenn sie nicht von Ihrer Anwendung verwendet werden:
  • data
  • pwzAttributes
  • securityData
  • dwVersion
Wenn eines der folgenden Member NULL ist, führt die Peer Graphing-API das angegebene Standardverhalten aus:
  • pwzCreatorId : Verwendet die Peer-ID, die an PeerGraphCreate oder PeerGraphOpen übergeben wird.
  • pwzModifiedById : Verwendet die pwzCreatorId.
Die folgenden Elemente können nicht angegeben werden: Alle verwendeten Werte werden von der Peer Graphing-Infrastruktur überschrieben:
  • id.
  • ftCreation : Verwendet Peerzeit.
  • ftLastModified : Verwendet Peerzeit.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile p2p.h
Bibliothek P2PGraph.lib
DLL P2PGraph.dll

Weitere Informationen

PEER_RECORD

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate