XboxLiveEndpointPairTemplate Класс

Определение

Пространство имен:

Windows.Networking.XboxLive

Представляет предварительно настроенный шаблон для обеспечения оптимального и безопасного взаимодействия между двумя устройствами с помощью сокетов. Шаблон, определенный этим классом, описывает, как две конечные точки соединены в XboxLiveEndpointPair. Шаблоны статически объявляются в сетевом манифесте приложения, а затем идентифицируются с помощью уникальных строк имен.

Примечание

Шаблоны объявляются только в сетевом манифесте приложения. Вы не можете объявить или изменить шаблон во время выполнения.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.

public ref class XboxLiveEndpointPairTemplate sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XboxLiveEndpointPairTemplate final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class XboxLiveEndpointPairTemplate

Public NotInheritable Class XboxLiveEndpointPairTemplate

Наследование

Object Platform::Object IInspectable XboxLiveEndpointPairTemplate

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Xbox One System Apps Extensions for the UWP (появилось в 10.0.0.1) Xbox Live Extension SDK (появилось в 10.0.10240.0) Xbox One Extensions for the UWP (появилось в 10.0.10240.0) Windows Desktop Extension SDK (появилось в 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (появилось в v1.0)

Комментарии

Код не создает экземпляр этого класса с помощью конструктора. Вместо этого создается экземпляр определенного предопределенного шаблона путем вызова статического метода XboxLiveEndpointPairTemplate.GetTemplateByName с именем нужного шаблона.

Свойства

AcceptorBoundPortRangeLower	Возвращает нижний предел диапазона портов, привязанного к приему, как определено в сетевом манифесте приложения. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
AcceptorBoundPortRangeUpper	Возвращает верхний предел диапазона портов, привязанного к приему, как определено в манифесте сети приложения. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
EndpointPairs	Статическое свойство, которое получает список текущих объектов XboxLiveEndpointPair , созданных с помощью этого шаблона. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
InitiatorBoundPortRangeLower	Возвращает нижний предел диапазона портов, привязанного инициатором, как определено в сетевом манифесте приложения. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
InitiatorBoundPortRangeUpper	Возвращает верхний предел диапазона портов, привязанного инициатором, как определено в сетевом манифесте приложения. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
Name	Возвращает имя шаблона (объявленного в сетевом манифесте приложения), который использовался для создания экземпляра этого объекта. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
SocketKind	Возвращает значение, указывающее тип сокета, объявленного этим шаблоном. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
Templates	Статическое свойство, которое выводит список всех шаблонов, объявленных приложением. Шаблоны объявляются в сетевом манифесте приложения во время сборки и не могут быть объявлены или изменены во время выполнения. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.

Методы

CreateEndpointPairAsync(XboxLiveDeviceAddress)	Создает xboxLiveEndpointPair между локальным устройством и указанным удаленным устройством на основе текущего шаблона с поведением создания XboxLiveEndpointPairCreationBehaviors.None. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
CreateEndpointPairAsync(XboxLiveDeviceAddress, XboxLiveEndpointPairCreationBehaviors)	Создает xboxLiveEndpointPair между локальным и указанным удаленным устройством, указывая поведение системы, если xboxLiveEndpointPair уже существует для этого шаблона и удаленного устройства. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String)	Создает пару конечных точек между локальным устройством и указанным удаленным устройством, указывая определенные порты из указанного шаблона диапазона допустимых портов с поведением создания XboxLiveEndpointPairCreationBehaviors.None. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
CreateEndpointPairForPortsAsync(XboxLiveDeviceAddress, String, String, XboxLiveEndpointPairCreationBehaviors)	Создает пару конечных точек между локальным устройством и указанным удаленным устройством, указывая определенные порты из назначенных шаблоном диапазонов допустимых портов и указывая, как должна вести себя система, если xboxLiveEndpointPair уже существует для этого шаблона, удаленного устройства и сочетания портов. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
GetTemplateByName(String)	Статический метод, который создает xboxLiveEndpointPairTemplate для именованного шаблона. Шаблоны определяются в сетевом манифесте приложения. Каждому шаблону в манифесте должно быть присвоено уникальное имя. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.

События

InboundEndpointPairCreated

Событие, возникающее, когда удаленное устройство успешно создает пару конечных точек от себя к локальному компьютеру. Сведения о новой паре конечных точек можно найти в аргументах события. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.