PeerGraphOpen 函式 (p2p.h)
PeerGraphOpen 函式會開啟先前由本機節點或遠端節點建立的對等圖形。 傳回對等圖形的句柄，但未建立網路連線。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphOpen(
[in] PCWSTR pwzGraphId,
[in] PCWSTR pwzPeerId,
[in] PCWSTR pwzDatabaseName,
[in] PPEER_SECURITY_INTERFACE pSecurityInterface,
[in] ULONG cRecordTypeSyncPrecedence,
[in] const GUID *pRecordTypeSyncPrecedence,
[out] HGRAPH *phGraph
);
參數
[in] pwzGraphId
指定要開啟的對等圖形標識碼。 此標識碼必須與 對 PeerGraphCreate 呼叫中使用的標識符相同。
[in] pwzPeerId
指定開啟圖形之對等的唯一標識符。
[in] pwzDatabaseName
指定第一次建立或開啟圖形時，與這個對等圖形相關聯的資料庫名稱。
[in] pSecurityInterface
指定對等圖形的安全性提供者。 此參數必須指定與對 PeerGraphCreate 原始呼叫中指定的 pSecurityInterface 相同的值。
[in] cRecordTypeSyncPrecedence
指定 pRecordTypeSyncPrecedence 參數中的記錄類型數目。
[in] pRecordTypeSyncPrecedence
指向記錄類型的陣列。 此陣列會指定同步處理指定記錄類型之記錄的順序。 順序可以是零 (0) 到 N，其中 0 是第一個要同步處理的記錄類型。 如果未在陣列中指定記錄類型，則會以預設順序同步處理陣列中指定的類型。
指定 NULL 以使用預設順序。 如果 cRecordTypeSyncPrecedence 為零，則此參數必須為 NULL (0) 。
[out] phGraph
接收已開啟之對等圖形的句柄。 當不需要或需要此句柄時，請呼叫 PeerGraphClose來釋放此句柄。
傳回值
如果已成功開啟現有的資料庫，則傳回S_OK。 否則，函式會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
|
其中一個參數無效。 |
|
記憶體不足，無法執行指定的作業。 |
|
找不到現有的資料庫，而且已成功建立新的資料庫。 如果找到並成功開啟現有的資料庫，則會傳回 S_OK 。 |
|
對等圖形的句柄無效。 |
|
使用這個函式之前，必須先使用 對PeerGraphStartup 的呼叫來初始化對等圖形。 |
備註
如果您已經開發自己的 SSP，您的應用程式不得呼叫 PeerGraphing API 來存取圖形資料庫中的數據，因為這可能會導致死結的情況。 相反地，應用程式應該查看資訊的快取複本。
呼叫 PeerGraphOpen 之後，應用程式可以訂閱事件或匯入資料庫，或同時訂閱兩者。
在同步處理對等圖形至少一次之前， (無法使用許多函式，例如 PeerGraphListen 或任何記錄管理功能) ，而且對這些函式所做的任何呼叫都會失敗。 當發生下列其中一項時，對等圖形至少會同步處理一次：
- 對 PeerGraphOpen 的呼叫會 傳回S_OK，這表示已找到已同步處理的資料庫。
- 已呼叫PeerGraphCreate函式。
- 已觸發 PEER_GRAPH_EVENT_STATUS_CHANGED 事件，而且已設定 dwStatus 成員的PEER_GRAPH_STATUS_SYNCHRONIZED旗標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2PGraph.lib |
| Dll | P2PGraph.dll |