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


структура SERVICE_DESCRIPTIONA (winsvc.h)

Содержит описание службы.

Синтаксис

typedef struct _SERVICE_DESCRIPTIONA {
  LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;

Члены

lpDescription

Описание службы. Если этот элемент имеет значение NULL, описание остается неизменным. Если это значение является пустой строкой (""), текущее описание удаляется.

Описание службы не должно превышать размер значения реестра типа REG_SZ.

Этот член может указать локализованную строку в следующем формате:

@[path]dllname,-strID

Строка с идентификатором strID загружается из dllname; Путь необязателен. Дополнительные сведения см. в разделе RegLoadMUIString.

Windows Server 2003 и Windows XP: Локализованные строки не поддерживаются до Windows Vista.

Комментарии

Описание со значением NULL указывает на отсутствие описания службы. При создании службы описание службы имеет значение NULL.

Описание — это просто комментарий, объясняющий назначение службы. Например, для службы DHCP можно использовать описание "Предоставляет интернет-адреса для компьютера в сети".

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

Примеры

Пример см. в разделе Изменение конфигурации службы или Запрос конфигурации службы.

Примечание

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

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть winsvc.h (включая Windows.h)

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

ChangeServiceConfig2

QueryServiceConfig2