PeerPnrpResolve 函式 (p2p.h)

PeerPnrpResolve 函式會取得 () 針對特定對等名稱註冊的端點位址。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpResolve(
  [in]           PCWSTR                   pcwzPeerName,
  [in, optional] PCWSTR                   pcwzCloudName,
  [in, out]      ULONG                    *pcEndpoints,
  [out]          PPEER_PNRP_ENDPOINT_INFO *ppEndpoints
);

參數

[in] pcwzPeerName

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

[in, optional] pcwzCloudName

零終止字串的指標，其中包含要解析對等名稱的 PNRP 雲端名稱。 如果 為 NULL，則會在所有雲端中執行解析。 如果PEER_PNRP_ALL_LINK_CLOUDS，則會在所有連結本機雲端中執行解析。 當「GLOBAL_」時，解析只會在全域雲端中發生。

[in, out] pcEndpoints

在 ppEndpoints 中傳回的端點數目上限。 傳回時，此參數包含 ppEndpoints 中的實際端點數目。

[out] ppEndpoints

包含成功解析對等名稱之端點之 PEER_PNRP_ENDPOINT_INFO 結構的指標。 每個端點都包含一或多個IP位址，可供連線到對等節點。

傳回值

如果函式呼叫成功，傳回值 會S_OK。 否則，它會傳回下列其中一個值。

備註

此呼叫是同步的，將會封鎖直到完成為止。 針對異步對等名稱解析，請呼叫 PeerPnrpStartResolve ，並在引發提供的事件時取得已解析的端點位址。

句柄必須在已登錄的進程中個別解析。 如果句柄已在相同的進程中註冊並解析，則無法辨識它。

針對所有雲端執行解決方案時，它會同時發出給每個雲端。 方法會在收到來自任何雲端組合的足夠結果時立即傳回。

此方法在內部使用的預設解析逾時為30秒。 如果需要特定的逾時，應該使用異步 PeerPnrpStartResolve 函式。

規格需求

另請參閱

PeerPnrpStartResolve