Функция WdsCliLog (wdsclientapi.h)

Статья
08/27/2023

Отправляет событие журнала на сервер WDS.

Синтаксис

HRESULT WDSCLIAPI WdsCliLog(
  [in] HANDLE hSession,
  [in] ULONG  ulLogLevel,
  [in] ULONG  ulMessageCode,
       ...    
);

Параметры

[in] hSession

Дескриптор сеанса с сервером WDS. Это был дескриптор, возвращенный функцией WdsCliCreateSession .

[in] ulLogLevel

Указывает пороговую серьезность, необходимую для регистрации события. Сервер WDS будет регистрировать события только в том случае, если уровень журнала сервера больше или равен указанному значению.

Этот параметр может иметь одно из следующих значений.

WDS_LOG_LEVEL_DISABLED (0)

WDS_LOG_LEVEL_ERROR (1)

WDS_LOG_LEVEL_WARNING (2)

WDS_LOG_LEVEL_INFO (3)

[in] ulMessageCode

Тип регистрируемого сообщения.

Значение	Значение
WDS_LOG_TYPE_CLIENT_ERROR 1	Сообщение об ошибке клиента. Требуется дополнительный параметр типа PWSTR , описывающий ошибку.
WDS_LOG_TYPE_CLIENT_STARTED 2	Сообщение о запуске клиента. Никаких дополнительных параметров не требуется.
WDS_LOG_TYPE_CLIENT_FINISHED 3	Сообщение о завершении клиента. Никаких дополнительных параметров не требуется.
WDS_LOG_TYPE_CLIENT_IMAGE_SELECTED 4	Выбранное сообщение с изображением клиента. Требуются два дополнительных параметра типа PWSTR . Первый — это имя образа, а второй — имя группы.
WDS_LOG_TYPE_CLIENT_APPLY_STARTED 5	Никаких дополнительных параметров не требуется.
WDS_LOG_TYPE_CLIENT_APPLY_FINISHED 6	Никаких дополнительных параметров не требуется.
WDS_LOG_TYPE_CLIENT_GENERIC_MESSAGE 7	Универсальное сообщение. Требуется дополнительный параметр типа PWSTR , содержащий сообщение.
WDS_LOG_TYPE_CLIENT_MAX_CODE 8	Используется для определения индекса вне диапазона. Недопустимые значения, превышающие или равные WDS_LOG_TYPE_CLIENT_MAX_CODE.

...

Количество и тип дополнительных аргументов зависят от значения параметра ulMessageCode .

Возвращаемое значение

Если функция выполняется успешно, возвращается S_OK.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wdsclientapi.h
Библиотека	WdsClientAPI.lib
DLL	WdsClientAPI.dll

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

WdsCliCreateSession

Клиентские функции служб развертывания Windows

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