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 方法登录对等协作基础结构所需的调用方，或者在使用此方法之前。

访问此属性需要 的 PermissionStateUnrestricted。 协作会话开始时会创建 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 方法登录到对等协作基础结构。

访问此属性需要 的 PermissionStateUnrestricted。 协作会话开始时会创建 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()