PeerGraphCreate 函式 (p2p.h)

發行項
03/05/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 。否則，函式會傳回下列其中一個值。

傳回碼	Description
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_E_DUPLICATE_GRAPH	具有已存在之指定對等圖形標識碼的資料庫。
PEER_E_NOT_INITIALIZED	使用這個函式之前，必須先呼叫 PeerGraphStartup 來初始化對等圖形。

備註

如果您開發自己的安全性服務提供者 (SSP) ，您的應用程式不得呼叫對等圖形 API 來存取對等圖形資料庫中的數據，因為這可能會導致死結狀況。相反地，應用程式必須使用資訊的快取複本。快取的複本不是由對等圖形 API 所建立。應用程式必須提供快取此數據的機制。

呼叫 PeerGraphCreate 之後，應用程式就可以在呼叫 PeerGraphListen 之前訂閱事件。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h
程式庫	P2PGraph.lib
Dll	P2PGraph.dll