XboxLiveEndpointPair Класс

Определение

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

Windows.Networking.XboxLive

XboxLiveEndpointPair — это отношение безопасности и качества сети, установленное между двумя устройствами для обмена данными на основе сокетов.

API Windows.Networking.XboxLive обеспечивает одноранговое подключение (P2P) в различных средах, используя IPv4, IPv6 и технологии и службы преобразования сетевых адресов (NAT) Майкрософт (например, Teredo), чтобы определить и настроить наилучший доступный сетевой путь между конечными точками. Он также устанавливает шифрование трафика и защиту от незаконного изменения в качестве меры для снижения количества обмана. Кроме того, он проверяет подлинность пользователей и приложений через экосистему Xbox Live&dmash; интеграция сведений о подключении с другими службами Xbox Live. Затем эти сведения можно использовать при подборе матчей, чтобы попытаться сопоставить игроков с аналогичной статистикой подключения друг с другом.

API Windows.Networking.XboxLive дополняет и расширяет традиционные сетевые транспорты, такие как TCP и UDP, а также доступные API сокетов, WinSock и Windows.Networking.Sockets. Вы создаете XboxLiveEndpointPair с помощью этого API, а затем используете предпочтительный API транспорта для фактической передачи данных. Сама концепция XboxLiveEndpointPair связана с Windows.Networking.EndpointPair в том, что ее можно интерпретировать как набор локальных и удаленных IP-адресов и портов; но в XboxLiveEndpointPair эти свойства доступны только для чтения (так как система согласовывает их) и имеют связанное время действия (так как XboxLiveEndpointPair представляет собой активное отношение безопасности, которое может быть прекращено по различным причинам).

Важно!

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

public ref class XboxLiveEndpointPair 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 XboxLiveEndpointPair 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 XboxLiveEndpointPair

Public NotInheritable Class XboxLiveEndpointPair

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

Object Platform::Object IInspectable XboxLiveEndpointPair

Атрибуты

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)

Комментарии

Экземпляры этого класса не создаются с помощью конструктора. Вместо этого вы используете один из методов CreateEndpointPairAsync или CreateEndpointPairForPorts в классе XboxLiveEndpointPairTemplate , чтобы создать пару конечных точек, которая следует определенному шаблону связи.

Свойства

LocalHostName	Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
LocalPort	Возвращает порт для локальной конечной точки. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
RemoteDeviceAddress	Возвращает xboxLiveDeviceAddress для удаленной конечной точки. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
RemoteHostName	Возвращает имя узла для удаленной конечной точки. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
RemotePort	Возвращает порт для удаленной конечной точки. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
State	Возвращает значение, представляющее состояние этого xboxLiveEndpointPair. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
Template	Возвращает xboxLiveEndpointPairTemplate, используемый для создания экземпляра этой пары конечных точек. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.

Методы

DeleteAsync()	Начинает корректное завершение связи безопасности XboxLiveEndpointPair между двумя конечными точками. Предпринята попытка уведомить удаленное устройство, хотя нет никакой гарантии, что это уведомление будет получено, если удаленное устройство больше не доступно или недоступно. Вместо этого удаленное устройство может истестечить время ожидания XboxLiveEndpointPair. Действие будет выполнено успешно независимо от удаленного устройства или предыдущего состояния XboxLiveEndpointPair. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)	Находит существующий экземпляр XboxLiveEndpointPair , если он существует, связанный с трафиком от первого узла и порта к второму узлу и порту. Используйте этот метод для обратной работы от входящего трафика к xboxLiveEndpointPair , связанному с этим трафиком. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])	Находит существующий экземпляр XboxLiveEndpointPair , если он существует, связанный с трафиком между двумя заданными адресами сокетов, где адреса сокетов предоставляются в виде массивов Byte, содержащих SOCKADDR_STORAGE Winsock или связанные структуры. Используйте этот метод для обратной работы от входящего трафика к XboxLiveEndpointPair , связанному с этим трафиком. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
GetLocalSocketAddressBytes(Byte[])	Возвращает сведения об адресе сокета локальной конечной точки в виде массива byte. Этот метод заполняет указанный буфер байтов SOCKADDR_STORAGE адресом локального устройства для использования в последующих операциях Winsock с использованием API многопользовательской сети Xbox Live. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
GetRemoteSocketAddressBytes(Byte[])	Получает сведения об адресе сокета удаленной конечной точки в виде массива byte. Этот метод заполняет указанный буфер байтов SOCKADDR_STORAGE адресом удаленного устройства для использования в последующих операциях Winsock с использованием API многопользовательской сети Xbox Live. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.

События

StateChanged

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