PeerCollaboration.GetLocalRegisteredApplications 方法

定義

命名空間:

System.Net.PeerToPeer.Collaboration

組件:

System.Net.dll

取得在本機電腦上註冊之 PeerApplication 物件的集合。

多載

GetLocalRegisteredApplications()	取得在本機電腦上註冊的所有 PeerApplication 物件。
GetLocalRegisteredApplications(PeerApplicationRegistrationType)	為指定的 PeerApplication，取得本機電腦上註冊之所有 PeerApplicationRegistrationType 物件的集合。

範例

下列範例程式代碼說明如何擷取使用共同作業基礎結構註冊的應用程式集合：

// Enumerating all local registered applications.
private static void EnumLocalRegisteredApplications()
{
    PeerApplicationCollection pac = null;
    Console.WriteLine("Attempting to enumerate all local registered collaboration applications...");
    try
    {
        pac = PeerCollaboration.GetLocalRegisteredApplications(PeerApplicationRegistrationType.AllUsers);
        foreach (PeerApplication pa in pac)
        {
            Console.WriteLine("Registered application:\n ID: {0}\n Description: {1}\n", pa.Id, pa.Description);
        }
    }
    catch (PeerToPeerException p2pEx)
    {
        Console.WriteLine("The Peer Collaboration Infrastructure could not return an enumeration of the registered applications: {0}",
            p2pEx.Message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Unexpected exception caught when trying to enumerate the registered collaboration applications: {0}.",
            ex.Message);
    }
    finally
    {
        foreach (PeerApplication pa in pac)
        {
            pa.Dispose();
        }
    }
    return;
}

備註

呼叫端必須透過 SignIn 方法登入對等共同作業基礎結構，或在使用此方法之前登入。

存取這個屬性需要 PermissionState 的 Unrestricted。 當共同作業會話開始時， Peer 就會建立此狀態。

GetLocalRegisteredApplications()

取得在本機電腦上註冊的所有 PeerApplication 物件。

public:
 static System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetLocalRegisteredApplications();

public static System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetLocalRegisteredApplications ();

static member GetLocalRegisteredApplications : unit -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Shared Function GetLocalRegisteredApplications () As PeerApplicationCollection

傳回

PeerApplicationCollection

PeerApplicationCollection，內含本機電腦上註冊的所有應用程式。 如果找不到應用程式，就會傳回大小為零 (0) 的集合。

例外狀況

PeerToPeerException

當這個方法嘗試列舉註冊至這個對等電腦的應用程式時，傳回了無效的值。 請確認所有應用程式都有有效的登錄值。

備註

呼叫端必須先透過 方法登入對等共同作業基礎結構， SignIn 再使用此方法。

存取這個屬性需要 PermissionState 的 Unrestricted。 當共同作業會話開始時， Peer 就會建立此狀態。

另請參閱

• GetApplications
• GetPeersNearMe()
• PeerApplicationRegistrationType

GetLocalRegisteredApplications(PeerApplicationRegistrationType)

為指定的 PeerApplication，取得本機電腦上註冊之所有 PeerApplicationRegistrationType 物件的集合。

public:
 static System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetLocalRegisteredApplications(System::Net::PeerToPeer::Collaboration::PeerApplicationRegistrationType type);

[System.Security.SecurityCritical]
public static System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetLocalRegisteredApplications (System.Net.PeerToPeer.Collaboration.PeerApplicationRegistrationType type);

[<System.Security.SecurityCritical>]
static member GetLocalRegisteredApplications : System.Net.PeerToPeer.Collaboration.PeerApplicationRegistrationType -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Shared Function GetLocalRegisteredApplications (type As PeerApplicationRegistrationType) As PeerApplicationCollection

參數

type

PeerApplicationRegistrationType

要為指定的應用程式傳回的 PeerApplicationRegistrationType。

傳回

PeerApplicationCollection

PeerApplicationCollection，內含註冊於本機電腦上且屬於指定 type 的所有應用程式。 如果找不到應用程式，就會傳回大小為零 (0) 的集合。

屬性

SecurityCriticalAttribute

例外狀況

ArgumentOutOfRangeException

type 參數不是設定為 PeerApplicationRegistrationType 列舉型別中已知的值。

PeerToPeerException

當這個方法嘗試列舉註冊至這個對等電腦的應用程式時，傳回了無效的值。 請確認所有應用程式都有有效的登錄值。

備註

呼叫端必須先透過 SignIn 方法登入對等共同作業基礎結構，才能使用此方法。

存取這個方法需要 PermissionState 的 Unrestricted。 當共同作業會話開始時， Peer 就會建立此狀態。

另請參閱

• GetApplications
• GetPeersNearMe()