PeerCollaboration.RegisterApplication メソッド

定義

名前空間:
System.Net.PeerToPeer.Collaboration
アセンブリ:
System.Net.dll

呼び出し元ピアとのコラボレーション セッションに指定した PeerApplication を登録します。

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)

パラメーター

application
PeerApplication

関連付けられたスコープ (グローバル、ローカル、およびリンク ローカル) 内で呼び出し元ピアを登録する PeerApplication 。

type
PeerApplicationRegistrationType

実行する登録の種類。 アプリケーションは、呼び出し元のピアまたはマシンを使用するすべてのピアに対して登録できます。

属性
SecurityCriticalAttribute

例外

ArgumentException

  • Pathに渡されるPeerApplication オブジェクトのapplication プロパティがnull。

  • 指定されたピア アプリケーション インスタンスには、既に登録されているアプリケーションと同じグローバルに一意の Id があります。 指定された識別子で新しいアプリケーションを登録する前に、既存の登録を登録解除する必要があります。

ArgumentNullException

applicationパラメーターとtype パラメーターをnullすることはできません。 両方のパラメーターを指定する必要があります。

ArgumentOutOfRangeException

型パラメーターは、 PeerApplicationRegistrationType 列挙型の既知の値に設定されていません。

PeerToPeerException

呼び出し元がインフラストラクチャにサインインするまで、 RegisterApplication(PeerApplication, PeerApplicationRegistrationType) 操作を完了できません。

例

次のコード例は、アプリケーションをコラボレーション インフラストラクチャに登録する方法を示しています。

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

注釈

呼び出し元のピアは、このメソッドを呼び出す前に、 SignIn メソッドを使用してピア コラボレーション インフラストラクチャにサインインする必要があります。

このメソッドにアクセスするには、 PermissionState の Unrestrictedが必要です。 この状態は、 Peer コラボレーション セッションの開始時に作成されます。

適用対象