PeerGraphErstellenfunktion (p2p.h)

Artikel
03/01/2024

Die Funktion PeerGraphCreate erstellt ein neues Peerdiagramm. Eine Anwendung kann Informationen zu einem Peerdiagramm und den Sicherheitstyp angeben, den ein Peerdiagramm verwendet. Es wird ein Handle für ein Peerdiagramm zurückgegeben, aber keine Netzwerkverbindung hergestellt.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphCreate(
  [in]  PPEER_GRAPH_PROPERTIES   pGraphProperties,
  [in]  PCWSTR                   pwzDatabaseName,
  [in]  PPEER_SECURITY_INTERFACE pSecurityInterface,
  [out] HGRAPH                   *phGraph
);

Parameter

[in] pGraphProperties

Alle Eigenschaften eines Peergraphs in der PEER_GRAPH_PROPERTIES-Struktur .

[in] pwzDatabaseName

Der Name einer Datensatzdatenbank, die einem Peerdiagramm beim Erstellen zugeordnet werden soll. Der Name der Datensatzdatenbank muss ein gültiger Dateiname sein. Schließen Sie keinen Pfad mit dem Dateinamen ein. Eine vollständige Liste der Regeln für Dateinamen finden Sie im Element Benennen einer Datei in der Liste der Graphing-Reference_Links.

[in] pSecurityInterface

Die Informationen zu einem Sicherheitsanbieter für ein Peerdiagramm in der PEER_SECURITY_INTERFACE-Struktur .

[out] phGraph

Empfängt ein Handle für das peergraph, das erstellt wird. Wenn dieses Handle nicht mehr erforderlich ist, geben Sie es frei, indem Sie PeerGraphClose aufrufen.

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 Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen.
PEER_E_DUPLICATE_GRAPH	Eine Datenbank mit einer angegebenen Peerdiagramm-ID, die bereits vorhanden ist.
PEER_E_NOT_INITIALIZED	Das Peerdiagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

Hinweise

Wenn Sie Einen eigenen Security Service Provider (SSP) entwickeln, darf Ihre Anwendung die Peer Graphing-API nicht aufrufen, um auf Daten in der Peergraphingdatenbank zuzugreifen, da dies zu einem Deadlock führen kann. Stattdessen muss die Anwendung eine zwischengespeicherte Kopie der Informationen verwenden. Die zwischengespeicherte Kopie wird nicht von der Peer graphing-API erstellt. Die Anwendung muss einen Mechanismus zum Zwischenspeichern dieser Daten bereitstellen.

Nachdem PeerGraphCreate aufgerufen wurde, kann die Anwendung Ereignisse abonnieren, bevor PeerGraphListen aufgerufen wird.

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