PeerContact::GetApplications Method (PeerEndPoint^, Guid)

 

Gets the PeerApplicationCollection associated with the specified PeerEndPoint.

Namespace:   System.Net.PeerToPeer.Collaboration
Assembly:  System.Net (in System.Net.dll)

public:
[SecurityCriticalAttribute]
PeerApplicationCollection^ GetApplications(
	PeerEndPoint^ peerEndPoint,
	Guid applicationId
)

Parameters

peerEndPoint
Type: System.Net.PeerToPeer.Collaboration::PeerEndPoint^

The endpoint associated with the PeerApplicationCollection.

applicationId
Type: System::Guid

Contains application information associated with the PeerContact.

Return Value

Type: System.Net.PeerToPeer.Collaboration::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.

Exception Condition
ArgumentNullException

PeerEndPoint cannot be null.

InvalidOperationException
PeerToPeerException

Unable to complete GetApplications operation.

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.

.NET Framework
Available since 3.5
Return to top
Show: