WiFiDirectServiceAdvertiser Класс

Определение

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

Windows.Devices.WiFiDirect.Services

Представляет рекламодателя служб. Этот класс используется кодом на устройстве, которое объявляет Wi-Fi Direct Services для объявления службы.

public ref class WiFiDirectServiceAdvertiser sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WiFiDirectServiceAdvertiser final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WiFiDirectServiceAdvertiser

function WiFiDirectServiceAdvertiser(serviceName)

Public NotInheritable Class WiFiDirectServiceAdvertiser

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

Object Platform::Object IInspectable WiFiDirectServiceAdvertiser

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

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

Семейство устройств	Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Это один из нескольких классов, которые поддерживают подключение двух устройств с предпочтением того, какое устройство должно быть владельцем группы. См. статью Windows.Devices.WiFiDirect.Service , чтобы обсудить связывание устройств и о том, как это может привести к игнорированию предпочтения владельца группы (и как это исправить).

Имя службы задается в конструкторе WiFiDirectServiceAdvertiser . Имена служб — это строки UTF-8 длиной не более 255 символов. Рекомендуется использовать обратную нотацию доменных имен, где DNS-имя владельца службы (например, "contoso.com") используется в качестве начала имени службы (например, "com.contoso.serviceX"). Это соглашение предназначено для упрощения выбора уникальных имен служб. Имена служб, начинающиеся с org.wi-fi.wfds, зарезервированы для использования Wi-Fi Alliance, и вы не можете использовать такие имена для службы.

Конструкторы

WiFiDirectServiceAdvertiser(String)

Создает экземпляр класса WiFiDirectServiceAdvertiser. Чтобы начать рекламировать Wi-Fi Direct Service, создайте экземпляр этого класса, задайте его свойства соответствующим образом для службы, а затем вызовите метод Start .

Свойства

AdvertisementStatus	Возвращает значение, описывающее текущее состояние объявления.
AutoAcceptSession	Возвращает или задает свойство автоприема для этого объявления службы.
CustomServiceStatusCode	Возвращает или задает код пользовательского состояния службы. Допустимо, только если свойство ServiceStatus имеет значение Custom.
DeferredSessionInfo	Возвращает или задает сведения, относящиеся к службе, которые передаются инициатору запроса сеанса при установлении сеанса не будет завершен сразу, как, например, когда служба ожидает ввода данных пользователем для выполнения запроса. Запрашивающий должен реализовать время ожидания 120 секунд при отсрочке запроса.
PreferGroupOwnerMode	Возвращает или задает значение, указывающее, требуется ли службе быть владельцем группы Wi-Fi прямого однорангового узла (P2P). Владелец группы позволяет службе осуществлять больший контроль над конфигурацией подключения P2P и процессом подключения. Дополнительные сведения см. в технических спецификациях Wi-Fi Direct P2P, доступных в Wi-Fi Alliance.
PreferredConfigurationMethods	Возвращает список (который реализует интерфейс IVector ) предпочтительных методов конфигурации сеанса. Код использует операции IVector в списке для добавления или удаления элементов из списка.
ServiceError	Возвращает определенный код ошибки, если параметр AdvertisementStatusпрерван.
ServiceInfo	Возвращает или задает большой двоичный объект сведений о службе. Формат и содержимое большого двоичного объекта определяются отдельной службой и предназначены для использования искателями во время обнаружения службы.
ServiceName	Получает имя службы.
ServiceNamePrefixes	Возвращает список префиксов имени службы, которые должны соответствовать этой службе, когда поиск по префиксам используется. В коде используются методы IVector для добавления или удаления элементов из списка.
ServiceStatus	Возвращает или задает состояние службы.

Методы

ConnectAsync(DeviceInformation)	Принимает запрос сеанса, не требуя ПИН-кода.
ConnectAsync(DeviceInformation, String)	Принимает запрос сеанса путем подключения с указанным ПИН-кодом.
Start()	Начинает рекламировать службу, используя текущие значения свойств для задания параметров объявления.
Stop()	Прекращает рекламировать службу. Это не влияет на существующие сеансы, подключенные к службе.

События

AdvertisementStatusChanged	Событие, возникающее при изменении значения свойства AdvertisementStatus .
AutoAcceptSessionConnected	Событие, возникаемое, когда служба автоматически принимает запрос сеанса. Обработчик событий должен устанавливать подключения сокетов для пар конечных точек, перечисленных в объекте аргументов события.
SessionRequested	Событие, возникающее, когда искатель запросил создание сеанса со службой, связанной с этим экземпляром WiFiDirectServiceAdvertiser. Чтобы принять запрос, вызовите WiFiDirectServiceAdvertiser.ConnectAsync в обработчике событий.