PeerCollaboration.RegisterApplication Método

Definición

Espacio de nombres:
System.Net.PeerToPeer.Collaboration
Ensamblado:
System.Net.dll

Registra el especificado PeerApplication para una sesión de colaboración con el elemento del mismo nivel que llama.

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)

Parámetros

application
PeerApplication

PeerApplication para el que se va a registrar el elemento del mismo nivel que llama dentro del ámbito asociado (global, local y local de vínculo).

type
PeerApplicationRegistrationType

Tipo de registro que se va a realizar. La aplicación puede registrarse solo para el sistema del mismo nivel que realiza la llamada o para todos los elementos del mismo nivel mediante la máquina.

Atributos
SecurityCriticalAttribute

Excepciones

ArgumentException

  • La Path propiedad del PeerApplication objeto pasado a application es null.

  • La instancia de aplicación del mismo nivel proporcionada tiene el mismo valor globalmente único Id que una aplicación que ya está registrada. El registro existente debe anularse el registro antes de que se pueda registrar una nueva aplicación con el identificador proporcionado.

ArgumentNullException

Los application parámetros y type no pueden ser null. Se deben especificar ambos parámetros.

ArgumentOutOfRangeException

El parámetro type no se establece en un valor conocido de la PeerApplicationRegistrationType enumeración.

PeerToPeerException

No RegisterApplication(PeerApplication, PeerApplicationRegistrationType) se puede completar la operación hasta que el autor de la llamada haya iniciado sesión en la infraestructura.

Ejemplos

En el ejemplo de código siguiente se muestra cómo registrar una aplicación con la infraestructura de colaboración:

// 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;
}

Comentarios

El elemento del mismo nivel de llamada es necesario para iniciar sesión en la infraestructura de colaboración del mismo nivel con el SignIn método antes de llamar a este método.

El acceso a este método requiere un PermissionState de Unrestricted. Este estado se crea cuando comienza la Peer sesión de colaboración.

Se aplica a