Funzione PeerGraphCreate (p2p.h)

Articolo
03/01/2024

La funzione PeerGraphCreate crea un nuovo grafo peer. Un'applicazione può specificare informazioni su un grafo peer e sul tipo di sicurezza usato da un grafo peer. Viene restituito un handle per un grafo peer, ma non viene stabilita una connessione di rete.

Sintassi

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

Parametri

[in] pGraphProperties

Tutte le proprietà di un grafico peer nella struttura PEER_GRAPH_PROPERTIES .

[in] pwzDatabaseName

Nome di un database di record da associare a un grafo peer al momento della creazione. Il nome del database di record deve essere un nome di file valido. Non includere un percorso con il nome del file. Per un elenco completo delle regole relative ai nomi di file, vedere l'elemento Naming a File nell'elenco di graphing Reference_Links.

[in] pSecurityInterface

Informazioni su un provider di sicurezza per un grafico peer nella struttura PEER_SECURITY_INTERFACE .

[out] phGraph

Riceve un handle per il grafico peer creato. Quando questo handle non è più necessario, liberarlo chiamando PeerGraphClose.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire un'operazione specificata.
PEER_E_DUPLICATE_GRAPH	Un database con un ID grafico peer specificato già esistente.
PEER_E_NOT_INITIALIZED	Il grafo peer deve essere inizializzato con una chiamata a PeerGraphStartup prima di usare questa funzione.

Commenti

Se si sviluppa un provider di servizi di sicurezza personalizzato, l'applicazione non deve chiamare l'API Peer Graphing per accedere ai dati nel database del peer graphing, perché ciò può causare una situazione di deadlock. L'applicazione deve invece usare una copia memorizzata nella cache delle informazioni. La copia memorizzata nella cache non viene creata dall'API Peer Graphing. L'applicazione deve fornire un meccanismo per la memorizzazione nella cache di questi dati.

Dopo la chiamata a PeerGraphCreate , l'applicazione può sottoscrivere gli eventi prima di chiamare PeerGraphListen.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2PGraph.lib
DLL	P2PGraph.dll