WdsCliLog 函式 (wdsclientapi.h)

將記錄事件傳送至 WDS 伺服器。

語法

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

[in] hSession

使用 WDS 伺服器的會話句柄。這是 WdsCliCreateSession 函式所傳回的句柄。

[in] ulLogLevel

指出記錄事件所需的臨界值嚴重性。只有在伺服器記錄層級大於或等於指定的值時，WDS 伺服器才會記錄事件。

此參數可以有下列其中一個值。

[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。