PeerContact.GetApplications Method

Definition

Namespace:

System.Net.PeerToPeer.Collaboration

Assembly:

System.Net.dll

Retrieves the PeerApplication objects that were registered by the remote peer into the local cache.

Overloads

GetApplications()	Retrieves the PeerApplication objects that were registered by the remote peer into the local cache.
GetApplications(Guid)	Gets the collection of PeerApplication objects with the specified Guid from the local cache.
GetApplications(PeerEndPoint)	Gets the PeerApplicationCollection associated with the specified PeerEndPoint.
GetApplications(PeerEndPoint, Guid)	Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

Remarks

This functionality is only exposed on the PeerContact class. This functionality is not exposed on any other type of peer for security reasons.

GetApplications()

Retrieves the PeerApplication objects that were registered by the remote peer into the local cache.

public:
 System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetApplications();

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetApplications ();

[<System.Security.SecurityCritical>]
member this.GetApplications : unit -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Function GetApplications () As PeerApplicationCollection

Returns

PeerApplicationCollection

The PeerApplicationCollection from the local cache. If associated applications are not found for the PeerEndPoint, a collection of size zero (0) is returned.

Attributes

SecurityCriticalAttribute

Exceptions

InvalidOperationException

• The calling peer is not subscribed to the PeerEndPoint.

• The calling peer has not yet called the RefreshData() method.

PeerToPeerException

Unable to complete GetApplications() operation.

Remarks

If the calling peer is not subscribed to the PeerContact associated with the specified PeerEndPoint the RefreshData method must be called prior to calling this method.

While the caller is not required to sign-in to the collaboration infrastructure for this method to complete successfully, a successful call to RefreshData or one of the Subscribe methods must have been completed while the caller was previously signed in.

This functionality is only exposed on the PeerContact class. This functionality is not exposed on any other type of peer for security reasons.

Notes to Callers

Calling this method requires a PermissionState of Unrestricted. This state is created when the peer collaboration session begins.

GetApplications(Guid)

Gets the collection of PeerApplication objects with the specified Guid from the local cache.

public:
 System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetApplications(Guid applicationId);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetApplications (Guid applicationId);

[<System.Security.SecurityCritical>]
member this.GetApplications : Guid -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Function GetApplications (applicationId As Guid) As PeerApplicationCollection

Parameters

applicationId

Guid

The Guid of the peer application to be retrieved.

Returns

PeerApplicationCollection

The PeerApplicationCollection from the local cache. If no applications are found with the specified applicationId, a collection of size zero (0) is returned.

Attributes

SecurityCriticalAttribute

Exceptions

InvalidOperationException

• The calling peer is not subscribed to the PeerEndPoint.

• The calling peer has not yet called the RefreshData() method.

PeerToPeerException

Unable to complete GetApplications() operation.

Remarks

If the calling peer is not subscribed to the PeerContact associated with the specified PeerEndPoint the RefreshData method must be called prior to calling this method.

While the caller is not required to sign-in to the collaboration infrastructure for this method to complete successfully, a successful call to RefreshData or one of the Subscribe methods must have been completed while the caller was previously signed in.

This functionality is only exposed on the PeerContact class. This functionality is not exposed on any other type of peer for security reasons.

Notes to Callers

Calling this method requires a PermissionState of Unrestricted. This state is created when the peer collaboration session begins.

See also

• PeerApplicationLaunchInfo

GetApplications(PeerEndPoint)

Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

public:
 System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetApplications(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetApplications (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint);

[<System.Security.SecurityCritical>]
member this.GetApplications : System.Net.PeerToPeer.Collaboration.PeerEndPoint -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Function GetApplications (peerEndPoint As PeerEndPoint) As PeerApplicationCollection

Parameters

peerEndPoint

PeerEndPoint

Contains endpoint information associated with the PeerContact.

Returns

PeerApplicationCollection

The PeerApplicationCollection associated with the specified PeerEndPoint. If applications are not associated with the specified PeerEndPoint, a collection of size zero (0) is returned.

Attributes

SecurityCriticalAttribute

Exceptions

ArgumentNullException

PeerEndPoint cannot be null.

InvalidOperationException

• The calling peer is not subscribed to the PeerEndPoint.

• The calling peer has not yet called the RefreshData() method.

PeerToPeerException

Unable to complete GetApplications() operation.

Remarks

If the calling peer is not subscribed to the PeerContact associated with the specified PeerEndPoint the RefreshData method must be called prior to calling this method.

While the caller is not required to sign-in to the collaboration infrastructure for this method to complete successfully, a successful call to RefreshData or one of the Subscribe methods must have been completed while the caller was previously signed in.

This functionality is only exposed on the PeerContact class. This functionality is not exposed on any other type of peer for security reasons.

Notes to Callers

Calling this method requires a PermissionState of Unrestricted. This state is created when the peer collaboration session begins.

See also

• PeerApplicationLaunchInfo
• RegisterApplication(PeerApplication, PeerApplicationRegistrationType)

GetApplications(PeerEndPoint, Guid)

Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

public:
 System::Net::PeerToPeer::Collaboration::PeerApplicationCollection ^ GetApplications(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, Guid applicationId);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerApplicationCollection GetApplications (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, Guid applicationId);

[<System.Security.SecurityCritical>]
member this.GetApplications : System.Net.PeerToPeer.Collaboration.PeerEndPoint * Guid -> System.Net.PeerToPeer.Collaboration.PeerApplicationCollection

Public Function GetApplications (peerEndPoint As PeerEndPoint, applicationId As Guid) As PeerApplicationCollection

Parameters

peerEndPoint

PeerEndPoint

The endpoint associated with the PeerApplicationCollection.

applicationId

Guid

Contains application information associated with the PeerContact.

Returns

PeerApplicationCollection

The collection of PeerApplication objects associated with the PeerEndPoint.

If applications identified by the ID are not found for the PeerEndPoint, or if the ID for the endpoint is null or invalid, a collection of size zero (0) is returned.

Attributes

SecurityCriticalAttribute

Exceptions

ArgumentNullException

PeerEndPoint cannot be null.

InvalidOperationException

• The calling peer is not subscribed to the PeerEndPoint.

• The calling peer has not yet called the RefreshData() method.

PeerToPeerException

Unable to complete GetApplications() operation.

Remarks

If the calling peer is not subscribed to the PeerContact associated with the specified PeerEndPoint the RefreshData method must be called prior to calling this method.

While the caller is not required to sign-in to the collaboration infrastructure for this method to complete successfully, a successful call to RefreshData or one of the Subscribe methods must have been completed while the caller was previously signed in.

This functionality is only exposed on the PeerContact class. This functionality is not exposed on any other type of peer for security reasons.

Notes to Callers

Calling this method requires a PermissionState of Unrestricted. This state is created when the peer collaboration session begins.

See also

• GetObjectData(SerializationInfo, StreamingContext)
• Invite
• PeerApplicationLaunchInfo