PeerCollaboration.RegisterApplication Metodo

Definizione

Spazio dei nomi:
System.Net.PeerToPeer.Collaboration
Assembly:
System.Net.dll

Registra l'oggetto specificato PeerApplication per una sessione di collaborazione con il peer chiamante.

public:
 static void RegisterApplication(System::Net::PeerToPeer::Collaboration::PeerApplication ^ application, System::Net::PeerToPeer::Collaboration::PeerApplicationRegistrationType type);
[System.Security.SecurityCritical]
public static void RegisterApplication(System.Net.PeerToPeer.Collaboration.PeerApplication application, System.Net.PeerToPeer.Collaboration.PeerApplicationRegistrationType type);
[<System.Security.SecurityCritical>]
static member RegisterApplication : System.Net.PeerToPeer.Collaboration.PeerApplication * System.Net.PeerToPeer.Collaboration.PeerApplicationRegistrationType -> unit
Public Shared Sub RegisterApplication (application As PeerApplication, type As PeerApplicationRegistrationType)

Parametri

application
PeerApplication

Oggetto PeerApplication per il quale registrare il peer chiamante nell'ambito associato (globale, locale e locale).

type
PeerApplicationRegistrationType

Tipo di registrazione da eseguire. L'applicazione può essere registrata solo per il peer chiamante o per tutti i peer che usano il computer.

Attributi
SecurityCriticalAttribute

Eccezioni

ArgumentException

  • La Path proprietà dell'oggetto PeerApplication passato a application è null.

  • L'istanza dell'applicazione peer fornita ha la stessa univocità Id globale di un'applicazione già registrata. La registrazione esistente deve essere annullata prima di poter registrare una nuova applicazione con l'identificatore specificato.

ArgumentNullException

I application parametri e type non possono essere null. È necessario specificare entrambi i parametri.

ArgumentOutOfRangeException

Il parametro type non è impostato su un valore noto nell'enumerazione PeerApplicationRegistrationType .

PeerToPeerException

L'operazione RegisterApplication(PeerApplication, PeerApplicationRegistrationType) non può essere completata finché il chiamante non ha eseguito l'accesso all'infrastruttura.

Esempio

L'esempio di codice seguente illustra come registrare un'applicazione con l'infrastruttura di collaborazione:

// Registering Notepad.exe as a collab application with a fixed GUID.
// Note: If you're using the application to send invitations,
// the same application with the same GUID must be registered on the remote peer machine.
private static PeerApplication RegisterCollabApp()
{
    PeerApplication application = null;
    string pathToApp = "%SystemRoot%\\notepad.exe";
    Guid appGuid = new Guid(0xAAAAAAAA, 0xFADE, 0xDEAF, 0xBE, 0xEF, 0xFF, 0xEE, 0xDD, 0xCC, 0xBB, 0xAE);

    application = new PeerApplication();
    application.Id = appGuid;
    application.Path = pathToApp;
    application.Description = "Peer Collaboration Sample -- notepad.exe";
    application.PeerScope = PeerScope.All;
    application.CommandLineArgs = "n";
    application.Data = ASCIIEncoding.ASCII.GetBytes("Test");

    Console.WriteLine("Attempting to register the application \"notepad.exe\"...");
    try
    {

        PeerApplicationCollection pac = PeerCollaboration.GetLocalRegisteredApplications(PeerApplicationRegistrationType.AllUsers);
        if (pac.Contains(application))
        {
            Console.WriteLine("The application is already registered on the peer.");
        }
        else
        {
            PeerCollaboration.RegisterApplication(application, PeerApplicationRegistrationType.AllUsers);
            Console.WriteLine("Application registration succeeded!");
        }
    }
    catch (ArgumentException argEx)
    {
        Console.WriteLine("The application was previously registered with the Peer Collaboration Infrastructure: {0}.", argEx.Message);
    }
    catch (PeerToPeerException p2pEx)
    {
        Console.WriteLine("The application failed to register with the Peer Collaboration Infrastructure: {0}", p2pEx.Message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("An unexpected exception occurred when trying to register the application: {0}.", ex.Message);
    }
    return application;
}

Commenti

Il peer chiamante è necessario per accedere all'infrastruttura di collaborazione peer con il SignIn metodo prima di chiamare questo metodo.

L'accesso a questo metodo richiede un PermissionState oggetto .Unrestricted Questo stato viene creato all'inizio della Peer sessione di collaborazione.

Si applica a