Función PeerGraphCreate (p2p.h)

Artículo
03/01/2024

La función PeerGraphCreate crea un nuevo gráfico del mismo nivel. Una aplicación puede especificar información sobre un grafo del mismo nivel y el tipo de seguridad que usa un grafo del mismo nivel. Se devuelve un identificador de un gráfico del mismo nivel, pero no se establece una conexión de red.

Sintaxis

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 las propiedades de un gráfico del mismo nivel en la estructura PEER_GRAPH_PROPERTIES .

[in] pwzDatabaseName

Nombre de una base de datos de registros que se va a asociar a un gráfico del mismo nivel cuando se crea. El nombre de la base de datos de registros debe ser un nombre de archivo válido. No incluya una ruta de acceso con el nombre de archivo. Para obtener una lista completa de las reglas relativas a los nombres de archivo, vea el elemento Nomenclatura de un archivo en la lista de gráficos Reference_Links.

[in] pSecurityInterface

Información sobre un proveedor de seguridad para un gráfico del mismo nivel en la estructura de PEER_SECURITY_INTERFACE .

[out] phGraph

Recibe un identificador para el gráfico del mismo nivel que se crea. Cuando este identificador ya no es necesario, liberelo llamando a PeerGraphClose.

Valor devuelto

Devuelve S_OK si la operación se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.

Código devuelto	Descripción
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria para realizar una operación especificada.
PEER_E_DUPLICATE_GRAPH	Una base de datos con un identificador de grafo del mismo nivel especificado que ya existe.
PEER_E_NOT_INITIALIZED	El gráfico del mismo nivel debe inicializarse con una llamada a PeerGraphStartup antes de usar esta función.

Comentarios

Si desarrolla su propio proveedor de servicios de seguridad (SSP), la aplicación no debe llamar a Peer Graphing API para acceder a los datos de la base de datos de grafos del mismo nivel, ya que puede provocar una situación de interbloqueo. En su lugar, la aplicación debe usar una copia almacenada en caché de la información. La API Peer Graphing no crea la copia almacenada en caché. La aplicación debe proporcionar un mecanismo para almacenar en caché estos datos.

Después de llamar a PeerGraphCreate , la aplicación puede suscribirse a eventos antes de llamar a PeerGraphListen.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2PGraph.lib
Archivo DLL	P2PGraph.dll