peerPnrpStartResolve 函式 (p2p.h)

PeerPnrpStartResolve 函式會啟動異步對等名稱解析作業。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpStartResolve(
  [in]           PCWSTR      pcwzPeerName,
  [in, optional] PCWSTR      pcwzCloudName,
  [in, optional] ULONG       cMaxEndpoints,
  [in]           HANDLE      hEvent,
  [out]          HRESOLUTION *phResolve
);

參數

[in] pcwzPeerName

以零結尾字串的指標，其中包含將取得端點位址的對等名稱。

[in, optional] pcwzCloudName

以零結尾字串的指標，其中包含要解析對等名稱之 PNRP 雲端的名稱。 如果 為 NULL，則會對所有雲端執行解析。 如果PEER_PNRP_ALL_LINK_CLOUDS，則會針對所有連結本機雲端執行解析。 指定「GLOBAL_」時，解決方案會在全域雲端中發生。

[in, optional] cMaxEndpoints

要針對對等名稱傳回的端點數目上限。

[in] hEvent

針對提供的對等名稱解析對等端點，並已準備好藉由呼叫PeerPnrpGetEndpoint來取用時發出訊號的事件。 此事件會針對 PNRP 服務所探索的每個端點發出訊號。 如果呼叫 PeerPnrpGetEndpoint 傳回PEER_NO_MORE，則該對等的所有端點都已找到。

[out] phResolve

這個對等名稱解析要求的句柄。 此句柄必須在引發解析事件之後提供給 PeerPnrpEndResolve ，而且端點是透過 對PeerPnrpGetEndpoint的對應呼叫來取得，如果作業失敗則為 。

傳回值

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

備註

PeerPnrpStartResolve 會建立異步對等名稱解析作業的句柄。

每當找到端點時，hEvent 中提供的事件句柄都會發出訊號，而且必須使用應用程式取得該端點的 phResolve 句柄呼叫 PeerPnrpGetEndpoint。

最後一個事件會指定PEER_E_NO_MORE錯誤碼，指出找到對應至 PeerPnrpStartResolve 之對等名稱的所有端點。 此時，應用程式必須使用 對 PeerPnrpEndResolve 的呼叫來關閉句柄。

句柄必須在進程中解析，其與註冊所在的進程不同。 如果句柄已在相同進程中註冊並解析，則無法辨識該句柄。

規格需求

另請參閱

PeerPnrpEndResolve

PeerPnrpGetEndpoint

PeerPnrpResolve