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

Статья
03/15/2023

Структура SERVICE_INFO содержит сведения о сетевой службе или типе сетевой службы.

Синтаксис

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

Члены

lpServiceType

Тип: LPGUID

Указатель на GUID, который является типом сетевой службы.

lpServiceName

Тип: LPTSTR

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

Если вы вызываете функцию SetService с параметром dwNameSpace , который имеет значение NS_DEFAULT, имя сетевой службы должно быть общим именем. Общее имя — это то, что обычно называется сетевой службой. Примером общего имени для сетевой службы является "My SQL Server".

При вызове функции SetService с параметром dwNameSpace , заданным для определенного имени службы, имя сетевой службы может быть общим или различающееся имя. Различающееся имя отличает службу от уникального расположения со службой каталогов. Пример различающегося имени для сетевой службы — "MS\SYS\NT\DEV\My SQL Server".

lpComment

Тип: LPTSTR

Указатель на строку, завершающуюся значением NULL, которая является комментарием или описанием для сетевой службы. Например, "Используется для обновлений разработки".

lpLocale

Тип: LPTSTR

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

dwDisplayHint

Тип: DWORD

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

Значение	Значение
RESOURCEDISPLAYTYPE_DOMAIN	Отображение сетевой службы в качестве домена.
RESOURCEDISPLAYTYPE_FILE	Отображение сетевой службы в виде файла.
RESOURCEDISPLAYTYPE_GENERIC	Метод, используемый для отображения объекта, не имеет значения.
RESOURCEDISPLAYTYPE_GROUP	Отображение сетевой службы в виде группы.
RESOURCEDISPLAYTYPE_SERVER	Отображение сетевой службы в качестве сервера.
RESOURCEDISPLAYTYPE_SHARE	Отображение сетевой службы в виде sharepoint.
RESOURCEDISPLAYTYPE_TREE	Отображение сетевой службы в виде дерева.

dwVersion

Тип: DWORD

Версия сетевой службы. Высокое слово этого значения указывает номер основной версии. Низкое слово этого значения указывает дополнительный номер версии.

dwTime

Тип: DWORD

Зарезервировано для последующего использования. Должен равняться нулю.

lpMachineName

Тип: LPTSTR

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

lpServiceAddress

Тип: LPSERVICE_ADDRESSES

Указатель на структуру SERVICE_ADDRESSES , содержащую массив SERVICE_ADDRESS структур. Каждая структура SERVICE_ADDRESS содержит сведения об адресе сетевой службы.

Сетевая служба может вызывать функцию getsockname , чтобы определить локальный адрес системы.

ServiceSpecificInfo

Тип: BLOB

Структура BLOB , указывающая сведения, определяемые службой.

Примечание Как правило, данные, на которые указывает элемент pBlobData структуры BLOB, не должны содержать указателей. Это связано с тем, что только сетевая служба знает формат данных; Копирование данных без таких знаний приведет к недействительности указателя. Если данные, на которые указывает pBlobData , содержат элементы переменной величины, смещения от pBlobData можно использовать для указания расположения этих элементов. Существует одно исключение из этого общего правила: когда pBlobData указывает на SERVICE_TYPE_INFO_ABS структуру. Это возможно, поскольку и структура SERVICE_TYPE_INFO_ABS , и все содержащиеся в ней SERVICE_TYPE_VALUE_ABS структуры являются предопределенными, и поэтому их форматы известны операционной системе.

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

Требования

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