共用方式為

peerGraphSetPresence 函式 (p2p.h)

  • 發行項

PeerGraphSetPresence 函式會明確開啟或關閉特定節點的目前狀態記錄發行。 此函式可以覆寫對等圖形屬性中的目前狀態設定。 呼叫此函式可讓 節點使用 PeerGraphEnumNodes 列舉。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSetPresence(
  [in] HGRAPH hGraph,
  [in] BOOL   fPresent
);

參數

[in] hGraph

對等圖形的句柄。

[in] fPresent

指定 TRUE 以強制對等圖形基礎結構發佈此節點的目前狀態記錄，這會覆寫 PEER_GRAPH_PROPERTIES 中cPresenceMax 所指定的設定。 指定 FALSE ，將節點傳回對等圖形屬性中指定的預設行為。

注意 根據對等圖形顯示狀態原則，將 fPresent 設定為 FALSE 並不保證已移除對等的目前狀態資訊。 這表示對等的存在已不再發佈。
 

傳回值

如果函數調用成功，傳回值會 S_OK。 否則，它會傳回下列其中一個值。

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
PEER_E_INVALID_GRAPH
 對等圖形的句柄無效。 無法發佈目前狀態資訊。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先使用 對PeerGraphStartup 的呼叫來初始化對等圖形。

備註

如果對等圖形尚未明確發佈目前狀態信息，當列舉對等圖形時，不會顯示節點。

規格需求

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

另請參閱

PeerGraphEnumNodes