PeerNameResolver.Resolve Méthode

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

Paramètres

Retours

Un PeerNameRecordCollection qui contient tous les enregistrements de nom de l'homologue (représentés comme objets PeerNameRecord ) associés au nom d'homologue spécifié. Pour les noms d'homologue non sécurisés, le même PeerName peut être inscrit par des utilisateurs différents dans le même Cloud, et associés à des points de terminaison différents.

Exceptions

Exemples

L’exemple de code suivant montre comment résoudre un PeerName publié dans n’importe quel 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);
        }
    }
}

Remarques

Cette méthode associe un nom d’homologue aux clouds. Tous les clouds sont interrogés pour .PeerName Si le nom de l’homologue ne peut pas être résolu ou est null, un PeerToPeerException est levée.

Pour les noms d’homologues non sécurisés, le même nom peut être inscrit (et associé à différents points de terminaison) par différents homologues au sein du même cloud.

L’appel de la PeerNameResolver méthode est similaire à l’appel de la Resolve méthode pour chaque enregistrement de nom d’homologue dans .PeerNameRecordCollection Notez que l’utilisation de la méthode Resolve sur un enregistrement de nom d’homologue individuel n’invalide pas la résolution de plusieurs noms d’homologues.

Pour chaque Resolve méthode, il existe une méthode équivalente ResolveAsync . Leurs listes de paramètres sont identiques, sauf que la méthode ResolveAsync inclut un jeton système pour la gestion asynchrone des événements.

Si le Cloud paramètre n’est pas fourni, la méthode utilise le Available raccourci pour renseigner les paramètres cloud.

L’événement ResolveCompleted est déclenché si l’opération de résolution se termine par erreur ou est annulée.

Voir aussi

• 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

Paramètres

Retours

PeerNameRecordCollection dont la taille est inférieure ou égale aux entrées maxRecords. Cette collection contient des enregistrements de nom d'homologue associés au PeerName qui a été résolu.

Exceptions

Remarques

Cette méthode associe un nom d’homologue aux clouds. Tous les clouds sont interrogés pour le nom de l’homologue. Pour les noms d’homologues non sécurisés, le même nom d’homologue peut être inscrit par différents utilisateurs dans le même Cloud, et associé à des points de terminaison différents. Si le PeerName ne peut pas être résolu (par exemple, le nom de l’homologue n’est pas publié), un PeerToPeerException est levée.

Pour chaque Resolve méthode, il existe une méthode équivalente ResolveAsync . Leurs listes de paramètres sont identiques, sauf que la méthode ResolveAsync inclut un jeton système pour la gestion asynchrone des événements.

L’événement ResolveCompleted est déclenché si l’opération de résolution se termine par erreur ou est annulée.

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

Paramètres

Retours

PeerNameRecordCollection qui contient tous les enregistrements de nom d'homologue (représentés comme objets PeerNameRecord ) associés au nom d'homologue spécifié. Pour les noms d'homologue non sécurisés, le même PeerName peut être inscrit par des utilisateurs différents dans le même Cloud, et associés à des points de terminaison différents.

Exceptions

Remarques

Si le PeerName ne peut pas être résolu (autrement dit, le nom de l’homologue n’est pas publié), un PeerToPeerException est levée.

Pour les noms d’homologues non sécurisés, le même nom peut être inscrit (et associé à différents points de terminaison) par différents homologues au sein du même cloud.

Pour chaque Resolve méthode, il existe une méthode équivalente ResolveAsync . Leurs listes de paramètres sont identiques, sauf que la méthode ResolveAsync inclut un jeton système pour la gestion asynchrone des événements.

Si le Cloud paramètre est null, utilise PeerNameResolver le Available raccourci pour remplir les Name, Scopeet ScopeId.

L’événement ResolveCompleted est déclenché si l’opération de résolution se termine par erreur ou est annulée.

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

Paramètres

Retours

PeerNameRecordCollection dont la taille est inférieure ou égale aux entrées maxRecords. Cette collection contient des enregistrements de nom d'homologue associés au PeerName qui a été résolu.

Attributs

SecurityCriticalAttribute

Exceptions

Remarques

Pour les noms d’homologues non sécurisés, le même nom peut être inscrit (et associé à différents points de terminaison) par différents homologues au sein du même cloud. Si le nom de l’homologue ne peut pas être résolu, un PeerToPeerException est levée.

Pour chaque Resolve méthode, il existe une méthode équivalente ResolveAsync . Leurs listes de paramètres sont identiques, sauf que la méthode ResolveAsync inclut un jeton système pour la gestion asynchrone des événements.

Si le Cloud paramètre est null, utilise PeerNameResolver le Available raccourci pour remplir les Name, Scopeet ScopeId.

L’événement ResolveCompleted est déclenché si l’opération de résolution se termine par erreur ou est annulée.