Поделиться через

структура 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. При необходимости это может получить доступ к привязке 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, завершается двумя символами NULL.
REG_SZ
 Строка, завершаемая значением NULL.

dwValueSize

Тип: DWORD

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

lpValueName

Тип: LPTSTR

Указатель на строку NULL-terminated string, которая является именем значения. Это имя зависит от пространства имен.

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

Постоянный Значение
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 передается в качестве члена SERVICE_INFOServiceSpecificInfo члена BLOB-объекта. Хотя элемент ServiceSpecificInfo , как правило, не должен содержать указатели, в случае структур SERVICE_TYPE_INFO_ABS и SERVICE_TYPE_VALUE_ABS делается исключение.

Заметка

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
заголовка nspapi.h

См. также

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService