PeerGraphCreate 函数 (p2p.h)

项目
03/04/2024

PeerGraphCreate 函数创建新的对等图。应用程序可以指定有关对等图的信息，以及对等图使用的安全性类型。返回对等图的句柄，但未建立网络连接。

语法

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

参数

[in] pGraphProperties

PEER_GRAPH_PROPERTIES 结构中对等图的所有属性。

[in] pwzDatabaseName

创建时要与对等图关联的记录数据库的名称。记录数据库名称必须是有效的文件名。不要包含具有文件名的路径。有关文件名规则的完整列表，请参阅 Graphing Reference_Links列表中的命名文件项。

[in] pSecurityInterface

有关 PEER_SECURITY_INTERFACE 结构中对等图的安全提供程序的信息。

[out] phGraph

接收所创建的对等图的句柄。如果不再需要此句柄，请通过调用 PeerGraphClose 来释放它。

返回值

如果操作成功，则返回 S_OK 。否则，函数将返回以下值之一。

返回代码	说明
E_INVALIDARG	其中一个参数无效。
E_OUTOFMEMORY	没有足够的内存来执行指定的操作。
PEER_E_DUPLICATE_GRAPH	具有已存在的指定对等图 ID 的数据库。
PEER_E_NOT_INITIALIZED	必须先通过调用 PeerGraphStartup 初始化对等图，然后才能使用此函数。

注解

如果开发自己的安全服务提供程序 (SSP) ，则应用程序不得调用对等图形 API 来访问对等关系图数据库中的数据，因为这可能会导致死锁情况。相反，应用程序必须使用信息的缓存副本。缓存的副本不是由对等图形 API 创建的。应用程序必须提供用于缓存此数据的机制。

调用 PeerGraphCreate 后，应用程序可以在调用 PeerGraphListen 之前订阅事件。

要求

要求	值
最低受支持的客户端	具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	p2p.h
Library	P2PGraph.lib
DLL	P2PGraph.dll