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

Статья
11/20/2024

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

Синтаксис

typedef struct _SERVICE_INFOW {
  LPGUID              lpServiceType;
  LPWSTR              lpServiceName;
  LPWSTR              lpComment;
  LPWSTR              lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPWSTR              lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOW, *PSERVICE_INFOW, *LPSERVICE_INFOW;

Члены

lpServiceType

Тип: LPGUID

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

lpServiceName

Тип: LPTSTR

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

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

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

lpComment

Тип: LPTSTR

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

lpLocale

Тип: LPTSTR

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

dwDisplayHint

Тип: DWORD

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

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

dwVersion

Тип: DWORD

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

dwTime

Тип: DWORD

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

lpMachineName

Тип: LPTSTR

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

lpServiceAddress

Тип: LPSERVICE_ADDRESSES

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

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

ServiceSpecificInfo

Тип: BLOB

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

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

Замечания

Заметка

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

Требования

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