WdsCliLog 函数 (wdsclientapi.h)

将日志事件发送到 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
标头 wdsclientapi.h
Library WdsClientAPI.lib
DLL WdsClientAPI.dll

另请参阅

WdsCliCreateSession

Windows 部署服务客户端函数