PeerContact.InviteAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Начинает асинхронную операцию приглашения конечной точки на присоединение к приложению PeerCollaboration, инициированному отправителем приглашения.
Перегрузки
| InviteAsync(Object) |
Начинает асинхронную операцию приглашения конечной точки на присоединение к приложению PeerCollaboration, инициированному отправителем приглашения. Приглашение идентифицируется с помощью заданного объекта Object. |
| InviteAsync(PeerEndPoint, Object) |
Начинает асинхронную операцию приглашения заданной конечной точки одноранговой сети на присоединение к приложению PeerCollaboration, инициированному отправителем приглашения. Приглашение идентифицируется с помощью заданного объекта Object. |
| InviteAsync(PeerApplication, String, Byte[], Object) |
Начинает операцию асинхронного приглашения с участием указанных конечных точек однорангового узла для соединения с указанной совместной работой PeerApplication, спонсируемой отправителем приглашения. |
| InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object) |
Начинает операцию асинхронного приглашения для указанного элемента PeerApplication, выполняя соединение с указанной совместной работой |
Комментарии
Для успешного System.Net.PeerToPeer.Collaboration выполнения этого метода вызывающий объект не требуется выполнять вход в инфраструктуру. Объект PeerInvitationResponse от приглашенного не совпадает с тем, который принимает приглашение для совместной работы. Если приглашение отправляется удаленному однорангового узла, на котором не установлено приложение, оно автоматически отклоняется.
InviteAsync(Object)
Начинает асинхронную операцию приглашения конечной точки на присоединение к приложению PeerCollaboration, инициированному отправителем приглашения. Приглашение идентифицируется с помощью заданного объекта Object.
public:
override void InviteAsync(System::Object ^ userToken);[System.Security.SecurityCritical]
public override void InviteAsync (object userToken);[<System.Security.SecurityCritical>]
override this.InviteAsync : obj -> unitPublic Overrides Sub InviteAsync (userToken As Object)Параметры
- userToken
- Object
Пользовательский объект, который требуется передать методу обратного вызова асинхронной операции. Используется также для идентификации отменяемой асинхронной операции. Задание параметра является обязательным. Необходимо также, чтобы он был уникальным среди всех текущих асинхронных операций приглашения.
- Атрибуты
Исключения
Параметр UserToken не может иметь значение null.
Объект PeerEndPoint был удален.
Id для текущего приложения не существует или является пустым.
Параметр PeerEndPointCollection не может иметь значение
null.
Комментарии
Для успешного System.Net.PeerToPeer.Collaboration выполнения этого метода вызывающий объект не требуется выполнять вход в инфраструктуру. Объект PeerInvitationResponse от приглашенного не совпадает с тем, который принимает приглашение для совместной работы. Если приглашение отправляется удаленному однорангового узла, на котором не установлено приложение, оно автоматически отклоняется.
Примечания для тех, кто вызывает этот метод
В классе определяются дополнительные перегрузки Peer вместо подклассов PeerContact и PeerNearMe.
Для вызова этого метода требуется .PermissionStateUnrestricted Это состояние создается при запуске однорангового сеанса совместной работы.
См. также раздел
Применяется к
InviteAsync(PeerEndPoint, Object)
Начинает асинхронную операцию приглашения заданной конечной точки одноранговой сети на присоединение к приложению PeerCollaboration, инициированному отправителем приглашения. Приглашение идентифицируется с помощью заданного объекта Object.
public:
void InviteAsync(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, System::Object ^ userToken);[System.Security.SecurityCritical]
public void InviteAsync (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, object userToken);[<System.Security.SecurityCritical>]
override this.InviteAsync : System.Net.PeerToPeer.Collaboration.PeerEndPoint * obj -> unitPublic Sub InviteAsync (peerEndPoint As PeerEndPoint, userToken As Object)Параметры
- peerEndPoint
- PeerEndPoint
Конечная точка или удаленный одноранговый узел, которым отправляется приглашение.
- userToken
- Object
Пользовательский объект, который требуется передать методу обратного вызова асинхронной операции. Используется также для идентификации отменяемой асинхронной операции. Задание параметра является обязательным. Необходимо также, чтобы он был уникальным среди всех текущих асинхронных операций приглашения.
- Атрибуты
Исключения
Параметр
UserTokenне может иметь значениеnull.Конечная точка, указанная в
peerEndPoint, не может иметь значениеnull.
Объект peerEndPoint не может иметь значение null.
Объект PeerEndPoint был удален.
Guid для текущего приложения не существует или является пустым.
Комментарии
Для успешного System.Net.PeerToPeer.Collaboration выполнения этого метода вызывающий объект не требуется выполнять вход в инфраструктуру. Объект PeerInvitationResponse от приглашенного не совпадает с тем, который принимает приглашение для совместной работы. Если приглашение отправляется удаленному однорангового узла, на котором не установлено приложение, оно автоматически отклоняется.
Примечания для тех, кто вызывает этот метод
В классе определяются дополнительные перегрузки Peer вместо подклассов PeerContact и PeerNearMe.
Для вызова этого метода требуется .PermissionStateUnrestricted Это состояние создается при запуске однорангового сеанса совместной работы.
См. также раздел
Применяется к
InviteAsync(PeerApplication, String, Byte[], Object)
Начинает операцию асинхронного приглашения с участием указанных конечных точек однорангового узла для соединения с указанной совместной работой PeerApplication, спонсируемой отправителем приглашения.
public:
override void InviteAsync(System::Net::PeerToPeer::Collaboration::PeerApplication ^ applicationToInvite, System::String ^ message, cli::array <System::Byte> ^ invitationData, System::Object ^ userToken);[System.Security.SecurityCritical]
public override void InviteAsync (System.Net.PeerToPeer.Collaboration.PeerApplication applicationToInvite, string message, byte[] invitationData, object userToken);[<System.Security.SecurityCritical>]
override this.InviteAsync : System.Net.PeerToPeer.Collaboration.PeerApplication * string * byte[] * obj -> unitPublic Overrides Sub InviteAsync (applicationToInvite As PeerApplication, message As String, invitationData As Byte(), userToken As Object)Параметры
- applicationToInvite
- PeerApplication
Приложение, для которого отправляется приглашение.
- message
- String
Сообщение, отправляемое удаленному одноранговому узлу вместе с приглашением на присоединение к приложению. Размер сообщения не может превышать 255 символов Юникода.
- invitationData
- Byte[]
Определенный пользователем большой двоичный объект, связываемый с приглашением. Его размер не может превышать 16384 байт.
- userToken
- Object
Пользовательский объект, который требуется передать методу обратного вызова асинхронной операции. Используется также для идентификации отменяемой асинхронной операции. Задание параметра является обязательным. Необходимо также, чтобы он был уникальным среди всех текущих асинхронных операций приглашения.
- Атрибуты
Исключения
Параметр UserToken не может иметь значение null.
Объект PeerApplication не может иметь значение null.
Объект PeerEndPoint был удален.
Guid для текущего приложения не существует или является пустым.
Коллекция конечных точек пуста или
null.
Комментарии
Для успешного System.Net.PeerToPeer.Collaboration выполнения этого метода вызывающий объект не требуется выполнять вход в инфраструктуру. Объект PeerInvitationResponse от приглашенного не совпадает с тем, который принимает приглашение для совместной работы. Если приглашение отправляется удаленному однорангового узла, на котором не установлено приложение, оно автоматически отклоняется.
Примечания для тех, кто вызывает этот метод
В классе определяются дополнительные перегрузки Peer вместо подклассов PeerContact и PeerNearMe.
Для вызова этого метода требуется .PermissionStateUnrestricted Это состояние создается при запуске однорангового сеанса совместной работы.
См. также раздел
Применяется к
InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object)
Начинает операцию асинхронного приглашения для указанного элемента PeerApplication, выполняя соединение с указанной совместной работой peerEndPoint, спонсируемой отправителем приглашения.
public:
void InviteAsync(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, System::String ^ message, cli::array <System::Byte> ^ invitationData, System::Net::PeerToPeer::Collaboration::PeerApplication ^ applicationToInvite, System::Object ^ userToken);[System.Security.SecurityCritical]
public void InviteAsync (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, string message, byte[] invitationData, System.Net.PeerToPeer.Collaboration.PeerApplication applicationToInvite, object userToken);[<System.Security.SecurityCritical>]
override this.InviteAsync : System.Net.PeerToPeer.Collaboration.PeerEndPoint * string * byte[] * System.Net.PeerToPeer.Collaboration.PeerApplication * obj -> unitPublic Sub InviteAsync (peerEndPoint As PeerEndPoint, message As String, invitationData As Byte(), applicationToInvite As PeerApplication, userToken As Object)Параметры
- peerEndPoint
- PeerEndPoint
Конечная точка или удаленный одноранговый узел, которым отправляется приглашение.
- message
- String
Сообщение, отправляемое удаленному одноранговому узлу вместе с приглашением на присоединение к приложению. Размер сообщения не может превышать 255 символов Юникода.
- invitationData
- Byte[]
Определяемый пользователем большой двоичный объект данных, который связывается с приглашением. Его размер не может превышать 16384 байт.
- applicationToInvite
- PeerApplication
Приложение, для которого отправляется приглашение.
- userToken
- Object
Пользовательский объект, который требуется передать методу обратного вызова асинхронной операции. Используется также для идентификации отменяемой асинхронной операции. Задание параметра является обязательным. Необходимо также, чтобы он был уникальным среди всех текущих асинхронных операций приглашения.
- Атрибуты
Исключения
Параметр
UserTokenне может быть равен null.Конечная точка, заданная
peerEndPoint, не может иметь значениеnull.
PeerApplication и PeerEndPoint не могут иметь значение null.
Объект PeerEndPoint был удален.
Id для текущего приложения не существует или является пустым.
Комментарии
Для успешного System.Net.PeerToPeer.Collaboration выполнения этого метода вызывающий объект не требуется выполнять вход в инфраструктуру. Объект PeerInvitationResponse от приглашенного не совпадает с тем, который принимает приглашение для совместной работы. Если приглашение отправляется удаленному однорангового узла, на котором не установлено приложение, оно автоматически отклоняется.
Примечания для тех, кто вызывает этот метод
В классе определяются дополнительные перегрузки Peer вместо подклассов PeerContact и PeerNearMe.
Для вызова этого метода требуется .PermissionStateUnrestricted Это состояние создается при запуске однорангового сеанса совместной работы.
