PeerNameResolver.Resolve 方法

public:
 System::Net::PeerToPeer::PeerNameRecordCollection ^ Resolve(System::Net::PeerToPeer::PeerName ^ peerName);

public System.Net.PeerToPeer.PeerNameRecordCollection Resolve(System.Net.PeerToPeer.PeerName peerName);

member this.Resolve : System.Net.PeerToPeer.PeerName -> System.Net.PeerToPeer.PeerNameRecordCollection

Public Function Resolve (peerName As PeerName) As PeerNameRecordCollection

參數

傳回

PeerNameRecordCollection A 包含所有與指定對等名稱相關的節點名稱記錄（以PeerNameRecord物件表示）。 對於未加密的對等名稱，同一 PeerName 節點可由不同使用者 Cloud註冊，並關聯到不同的端點。

例外狀況

範例

以下程式碼範例說明如何解析任何PeerName已發表的 Cloud 。

static void Main(string[] args)
{
    try
    {

        if (args.Length != 1)
        {
            Console.WriteLine("Usage: PeerNameResolver.exe <PeerNameToResolve>");
            return;
        }

        // create a resolver object to resolve a Peer Name that was previously published
        PeerNameResolver resolver = new PeerNameResolver();
        // The Peer Name to resolve must be passed as the first
        // command line argument to the application
        PeerName peerName = new PeerName(args[0]);
        // Resolve the Peer Name
        // This is a network operation and will block until the resolve completes
        PeerNameRecordCollection results = resolver.Resolve(peerName);

        // Display the data returned by the resolve operation
        Console.WriteLine("Resolve operation complete.\n", peerName);
        Console.WriteLine("Results for PeerName: {0}", peerName);
        Console.WriteLine();

        int count = 1;
        foreach (PeerNameRecord record in results)
        {
            Console.WriteLine("Record #{0} results...", count);

            Console.Write("Comment:");
            if (record.Comment != null)
            {
                Console.Write(record.Comment);
            }
            Console.WriteLine();

            Console.Write("Data:");
            if (record.Data != null)
            {
                // Assumes the data blob associated with the PeerName
                // is made up of ASCII characters
                Console.Write(System.Text.Encoding.ASCII.GetString(record.Data));
            }
            Console.WriteLine();

            Console.WriteLine("Endpoints:");
            foreach (IPEndPoint endpoint in record.EndPointCollection)
            {
                Console.WriteLine("\t Endpoint:{0}", endpoint);
                Console.WriteLine();
            }

            count++;
        }

        Console.ReadKey();
    }
    catch (Exception e)
    {
        Console.WriteLine("Error occurred while attempting to resolve the PeerName: {0}", e.Message);
        Console.WriteLine(e.StackTrace);

        // P2P is not supported on Windows Server 2003
        if (e.InnerException != null)
        {
            Console.WriteLine("Inner Exception is {0}", e.InnerException);
        }
    }
}

備註

此方法將節點名稱與雲關聯起來。 所有雲都查詢 。PeerName 若節點名稱無法解析或為 ， null則拋出 an PeerToPeerException 。

對於不安全的對等節點名稱，同一名稱可以被同一雲端內的不同節點註冊（並關聯到不同的端點）。

呼叫該PeerNameResolver方法類似於對每個節點名稱記錄Resolve呼叫該PeerNameRecordCollection方法。 請注意，對單一節點名稱記錄使用Resolve方法並不會導致解析多個節點名稱的行為失效。

每種 Resolve 方法都有等價 ResolveAsync 的方法。 它們的參數列表相同，但 ResolveAsync 方法包含用於非同步事件處理的系統標記。

若 Cloud 未提供參數，方法會利用 Available 捷徑填補雲端參數。

ResolveCompleted若解析操作錯誤完成或被取消，事件將被觸發。

另請參閱

• PeerNameRegistration

public:
 System::Net::PeerToPeer::PeerNameRecordCollection ^ Resolve(System::Net::PeerToPeer::PeerName ^ peerName, int maxRecords);

public System.Net.PeerToPeer.PeerNameRecordCollection Resolve(System.Net.PeerToPeer.PeerName peerName, int maxRecords);

member this.Resolve : System.Net.PeerToPeer.PeerName * int -> System.Net.PeerToPeer.PeerNameRecordCollection

Public Function Resolve (peerName As PeerName, maxRecords As Integer) As PeerNameRecordCollection

參數

傳回

PeerNameRecordCollection A的大小小於或等maxRecords於元素數。 此收藏包含與已解決問題 PeerName 相關的同儕姓名紀錄。

例外狀況

備註

此方法將節點名稱與雲關聯起來。 所有雲都會查詢節點名稱。 對於不安全的對等名稱，同一對等名稱可以被同一用戶 Cloud在同一個節點註冊，並綁定到不同的端點。 若無法解決（PeerName例如，節點名稱未公開），則拋出 。PeerToPeerException

每種 Resolve 方法都有等價 ResolveAsync 的方法。 它們的參數列表相同，但 ResolveAsync 方法包含用於非同步事件處理的系統標記。

ResolveCompleted若解析操作錯誤完成或被取消，事件將被觸發。

public:
 System::Net::PeerToPeer::PeerNameRecordCollection ^ Resolve(System::Net::PeerToPeer::PeerName ^ peerName, System::Net::PeerToPeer::Cloud ^ cloud);

public System.Net.PeerToPeer.PeerNameRecordCollection Resolve(System.Net.PeerToPeer.PeerName peerName, System.Net.PeerToPeer.Cloud cloud);

member this.Resolve : System.Net.PeerToPeer.PeerName * System.Net.PeerToPeer.Cloud -> System.Net.PeerToPeer.PeerNameRecordCollection

Public Function Resolve (peerName As PeerName, cloud As Cloud) As PeerNameRecordCollection

參數

傳回

PeerNameRecordCollection 該記錄包含所有與指定節點名稱相關聯的節點名稱記錄（以 PeerNameRecord 物件表示）。 對於未加密的對等名稱，同一 PeerName 節點可由不同使用者 Cloud註冊，並關聯到不同的端點。

例外狀況

備註

若無法解析（PeerName即未公開對等名稱），則拋出 。PeerToPeerException

對於不安全的對等節點名稱，同一名稱可以被同一雲端內的不同節點註冊（並關聯到不同的端點）。

每種 Resolve 方法都有等價 ResolveAsync 的方法。 它們的參數列表相同，但 ResolveAsync 方法包含用於非同步事件處理的系統標記。

若 Cloud 參數為 null，則 PeerNameResolver 會使用 Available 捷徑填入 Name、 Scope和 ScopeId。

ResolveCompleted若解析操作錯誤完成或被取消，事件將被觸發。

public:
 System::Net::PeerToPeer::PeerNameRecordCollection ^ Resolve(System::Net::PeerToPeer::PeerName ^ peerName, System::Net::PeerToPeer::Cloud ^ cloud, int maxRecords);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.PeerNameRecordCollection Resolve(System.Net.PeerToPeer.PeerName peerName, System.Net.PeerToPeer.Cloud cloud, int maxRecords);

[<System.Security.SecurityCritical>]
member this.Resolve : System.Net.PeerToPeer.PeerName * System.Net.PeerToPeer.Cloud * int -> System.Net.PeerToPeer.PeerNameRecordCollection

Public Function Resolve (peerName As PeerName, cloud As Cloud, maxRecords As Integer) As PeerNameRecordCollection

參數

傳回

PeerNameRecordCollection A的大小小於或等maxRecords於元素數。 此收藏包含與已解決問題 PeerName 相關的同儕姓名紀錄。

屬性

SecurityCriticalAttribute

例外狀況

備註

對於不安全的對等節點名稱，同一名稱可以被同一雲端內的不同節點註冊（並關聯到不同的端點）。 若無法解析對等名稱，則拋出 an PeerToPeerException 。

每種 Resolve 方法都有等價 ResolveAsync 的方法。 它們的參數列表相同，但 ResolveAsync 方法包含用於非同步事件處理的系統標記。

若 Cloud 參數為 null，則 PeerNameResolver 會使用 Available 捷徑填入 Name、 Scope和 ScopeId。

ResolveCompleted若解析操作錯誤完成或被取消，事件將被觸發。