Função PeerGraphCreate (p2p.h)

Artigo
03/09/2024

A função PeerGraphCreate cria um novo grafo par. Um aplicativo pode especificar informações sobre um grafo par e o tipo de segurança que um grafo par usa. Um identificador para um grafo par é retornado, mas uma conexão de rede não é estabelecida.

Sintaxe

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

Parâmetros

[in] pGraphProperties

Todas as propriedades de um grafo par na estrutura PEER_GRAPH_PROPERTIES .

[in] pwzDatabaseName

O nome de um banco de dados de registro a ser associado a um grafo par quando ele é criado. O nome do banco de dados de registro deve ser um nome de arquivo válido. Não inclua um caminho com o nome do arquivo. Para obter uma lista completa de regras relacionadas a nomes de arquivo, consulte Nomenclatura de um item de arquivo na lista de Reference_Links do Graphing.

[in] pSecurityInterface

As informações sobre um provedor de segurança para um grafo par na estrutura PEER_SECURITY_INTERFACE .

[out] phGraph

Recebe um identificador para o grafo par criado. Quando esse identificador não for mais necessário, libere-o chamando PeerGraphClose.

Retornar valor

Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Código de retorno	Descrição
E_INVALIDARG	Um dos parâmetros não é válido.
E_OUTOFMEMORY	Não há memória suficiente para executar uma operação especificada.
PEER_E_DUPLICATE_GRAPH	Um banco de dados com uma ID de grafo par especificada que já existe.
PEER_E_NOT_INITIALIZED	O grafo par deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

Se você desenvolver seu próprio Provedor de Serviços de Segurança (SSP), seu aplicativo não deverá chamar a API de Grafo par para acessar dados no banco de dados de grafo par, pois isso pode causar uma situação de deadlock. Em vez disso, o aplicativo deve usar uma cópia armazenada em cache das informações. A cópia armazenada em cache não é criada pela API de Grafo de Pares. O aplicativo deve fornecer um mecanismo para armazenar esses dados em cache.

Depois que PeerGraphCreate for chamado, o aplicativo poderá assinar eventos antes de chamar PeerGraphListen.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	p2p.h
Biblioteca	P2PGraph.lib
DLL	P2PGraph.dll