PeerPnrpGetEndpoint 函式 (p2p.h)
PeerPnrpGetEndpoint 函式會擷取在異步對等名稱解析作業期間解析的對等端點位址。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpGetEndpoint(
[in] HRESOLUTION hResolve,
[out] PPEER_PNRP_ENDPOINT_INFO *ppEndpoint
);
參數
[in] hResolve
上一次呼叫 PeerPnrpStartResolve 所傳回之異步對等名稱解析作業的句柄。
[out] ppEndpoint
PEER_PNRP_ENDPOINT_INFO 結構的位址 指標，其中包含上一個 對等呼叫PeerPnrpStartResolve中提供的對等名稱端點位址。
這個參數傳回的數據必須藉由呼叫 PeerFreeData 來釋出。
傳回值
如果函式呼叫成功，傳回值 會S_OK。 否則，它會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
其中一個參數無效。 |
|
記憶體不足，無法執行指定的作業。 |
|
已擷取對等的所有端點位址。 |
備註
PeerPnrpStartResolve 會建立異步對等名稱解析作業的句柄。
每當找到端點時，hEvent 中提供的事件句柄會發出訊號，而且必須透過應用程式取得該端點的 phResolve 句柄呼叫 PeerPnrpGetEndpoint。
最後一個事件會指定PEER_E_NO_MORE錯誤碼，指出找到對應至 PeerPnrpStartResolve 之對等名稱的所有端點。 此時，應用程式必須使用 對 PeerPnrpEndResolve 的呼叫來關閉句柄。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |