Peer.InviteAsync 方法

定義

命名空間:

System.Net.PeerToPeer.Collaboration

組件:

System.Net.dll

開始非同步邀請作業，這樣會傳送邀請給 Peer 以啟動特定的 PeerApplication。

多載

InviteAsync(Object)	開始非同步邀請作業，這樣會傳送邀請給 Peer 以啟動特定的 PeerApplication。
InviteAsync(PeerApplication, String, Byte[], Object)	開始非同步邀請作業，這樣會傳送邀請給 Peer 以啟動特定的 PeerApplication。

InviteAsync(Object)

開始非同步邀請作業，這樣會傳送邀請給 Peer 以啟動特定的 PeerApplication。

public:
 abstract void InviteAsync(System::Object ^ userToken);

public abstract void InviteAsync (object userToken);

abstract member InviteAsync : obj -> unit

Public MustOverride Sub InviteAsync (userToken As Object)

參數

userToken

Object

使用者定義的物件，用於傳遞至非同步作業的回呼以供識別。 此必要參數在進行中的所有非同步邀請作業中必須是唯一的。

例外狀況

ArgumentNullException

userToken 為 null。

PeerToPeerException

• 邀請期間發生錯誤。

• 目前執行的應用程式未向共同作業基礎結構註冊。

備註

呼叫這個方法需要 PermissionState 的 Unrestricted。 當對等共同作業會話開始時，就會建立此狀態。

另請參閱

• InviteAsyncCancel(Object)
• InviteCompleted
• InviteCompletedEventArgs

InviteAsync(PeerApplication, String, Byte[], Object)

開始非同步邀請作業，這樣會傳送邀請給 Peer 以啟動特定的 PeerApplication。

public:
 abstract void InviteAsync(System::Net::PeerToPeer::Collaboration::PeerApplication ^ applicationToInvite, System::String ^ message, cli::array <System::Byte> ^ invitationData, System::Object ^ userToken);

public abstract void InviteAsync (System.Net.PeerToPeer.Collaboration.PeerApplication applicationToInvite, string message, byte[] invitationData, object userToken);

abstract member InviteAsync : System.Net.PeerToPeer.Collaboration.PeerApplication * string * byte[] * obj -> unit

Public MustOverride Sub InviteAsync (applicationToInvite As PeerApplication, message As String, invitationData As Byte(), userToken As Object)

參數

applicationToInvite

PeerApplication

邀請會傳送給 PeerApplication。

message

String

要隨應用程式邀請傳送到遠端對等的訊息。 此訊息的大小上限是 255 個 Unicode 字元。

invitationData

Byte[]

使用者定義的資料 Blob，用於與邀請建立關聯。 大小可超過 16,384 個位元組。

userToken

Object

使用者定義的物件，用於傳遞至非同步作業的回呼以供識別。 此必要參數在進行中的所有非同步邀請作業中必須是唯一的。

例外狀況

ArgumentException

應用程式未向協同作業基礎結構註冊。

ArgumentNullException

userToken 為 null。

ArgumentOutOfRangeException

invitationData 大於 16,384 個位元組。

PeerToPeerException

• 邀請期間發生錯誤。

• 目前執行的應用程式未向共同作業基礎結構註冊。

備註

呼叫這個方法需要 PermissionState 的 Unrestricted。 當對等共同作業會話開始時，就會建立此狀態。

另請參閱

• InviteAsyncCancel(Object)
• InviteCompleted
• InviteCompletedEventArgs