структура SERVICE_DESCRIPTIONA (winsvc.h)
Содержит описание службы.
Синтаксис
typedef struct _SERVICE_DESCRIPTIONA {
LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;
Члены
lpDescription
Описание службы. Если этот элемент NULL, описание остается неизменным. Если это значение является пустой строкой (""), текущее описание удаляется.
Описание службы не должно превышать размер значения реестра типа REG_SZ.
Этот член может указать локализованную строку с помощью следующего формата:
@[ путь]имени dllname,-strID
Строка с идентификатором
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) |