Condividi tramite


Funzione PeerGraphCreate (p2p.h)

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

Vedi anche

PEER_GRAPH_PROPERTIES

PEER_SECURITY_INTERFACE

PeerGraphClose

PeerGraphConnect

PeerGraphListen

PeerGraphOpen