Share via

структура SERVICE_TYPE_VALUE_ABSA (nspapi.h)

  • Статья

Структура SERVICE_TYPE_VALUE_ABS содержит сведения о значении типа сетевой службы. Эти сведения могут быть характерными для пространства имен.

Синтаксис

typedef struct _SERVICE_TYPE_VALUE_ABSA {
  DWORD dwNameSpace;
  DWORD dwValueType;
  DWORD dwValueSize;
  LPSTR lpValueName;
  PVOID lpValue;
} SERVICE_TYPE_VALUE_ABSA, *PSERVICE_TYPE_VALUE_ABSA, *LPSERVICE_TYPE_VALUE_ABSA;

Члены

dwNameSpace

Тип: DWORD

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

Используйте одну из следующих констант, чтобы указать пространство имен:

Значение Значение
NS_DEFAULT
 Набор пространств имен по умолчанию. Функция запрашивает каждое пространство имен в этом наборе. Набор пространств имен по умолчанию обычно включает все пространства имен, установленные в системе. Однако системные администраторы могут исключить определенные пространства имен из набора. NS_DEFAULT — это значение, которое большинство приложений должны использовать для dwNameSpace.
NS_DNS
 Система доменных имен, используемая в Интернете для разрешения имен узлов.
NS_NETBT
 Уровень NetBIOS через TCP/IP. Все операционные системы Windows регистрируют свои имена компьютеров в NetBIOS. Это пространство имен используется для преобразования имени компьютера в IP-адрес, использующий эту регистрацию. Обратите внимание, что NS_NETBT может получить доступ к серверу WINS для выполнения разрешения.
NS_SAP
 Протокол NetWare Service Advertising. При необходимости он может получить доступ к привязке NetWare. NS_SAP — это динамическое пространство имен, позволяющее регистрирование служб.
NS_TCPIP_HOSTS
 Значение поиска в <файле systemroot>\system32\drivers\etc\hosts.
NS_TCPIP_LOCAL
 Локальные механизмы разрешения имен TCP/IP, включая сравнение с именем локального узла и поиск имен узлов и IP-адресов в кэше сопоставлений между узлами и IP-адресами.

dwValueType

Тип: DWORD

Тип данных значения. Укажите один из следующих типов:

Значение Значение
REG_BINARY
 Двоичные данные в любой форме.
REG_DWORD
 32-разрядное число.
REG_MULTI_SZ
 Массив заканчивающихся нулем строк, завершаемый двумя символами NULL.
REG_SZ
 Строка с нулевым символом в конце.

dwValueSize

Тип: DWORD

Размер (в байтах) значения, на которое указывает элемент lpValue . В случае REG_SZ и REG_MULTI_SZ строковых данных завершающие символы учитываются как часть размера.

lpValueName

Тип: LPTSTR

Указатель на строку, завершающуюся значением NULL, которая является именем значения. Это имя зависит от пространства имен.

Несколько часто используемых строк имен значений связаны с определенными константами. Эти строки имен включают следующие.

Константа Значение
SERVICE_TYPE_VALUE_SAPID
 "SapId"
SERVICE_TYPE_VALUE_CONN
 ConnectionOriented
SERVICE_TYPE_VALUE_TCPPORT
 "TcpPort"
SERVICE_TYPE_VALUE_UDPPORT
 "UdpPort"

lpValue

Тип: PVOID

Указатель на данные значения.

Комментарии

При использовании функции SetService для добавления типа сетевой службы в пространство имен структура SERVICE_TYPE_INFO_ABS передается в качестве члена большого двоичного объекта ServiceSpecificInfoструктуры SERVICE_INFO . Хотя элемент ServiceSpecificInfo обычно не должен содержать указателей, в случае SERVICE_TYPE_INFO_ABS и SERVICE_TYPE_VALUE_ABS структур создается исключение.

Примечание

Заголовок nspapi.h определяет SERVICE_TYPE_VALUE_ABS как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть nspapi.h

См. также раздел

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService