共用方式為

PFN_WdsCliCallback回呼函式 (wdsclientapi.h)

  • 發行項

定義 WDS 可在檔案或圖像傳輸期間呼叫進度通知和錯誤訊息的回呼函式。

語法

PFN_WdsCliCallback PfnWdsclicallback;

void PfnWdsclicallback(
  [in]           DWORD dwMessageId,
  [in, optional] WPARAM wParam,
  [in, optional] LPARAM lParam,
  [in, optional] PVOID pvUserData
)
{...}

參數

[in] dwMessageId

訊息的類型和 lParam 參數的意義。

此參數只能有下列其中一個值。

值 意義
WDS_CLI_MSG_START
0
 傳輸開始訊息。 lParam 參數是包含傳輸檔案大小的LARGE_INTEGER值的指標。
WDS_CLI_MSG_COMPLETE
1
 傳輸完整訊息。 lParam 參數是 HRESULT 值。
WDS_CLI_MSG_PROGRESS
2
 傳輸進度訊息。 lParam 參數是 ULONG 值，這是已完成傳輸的百分比。
WDS_CLI_MSG_TEXT
3
 參考訊息。 lParam 參數是可用於診斷用途的偵錯字串指標。

[in, optional] wParam

此訊息參數應該一律設定為 WdsCliTransferImage 或 WdsCliTransferFile 函式所傳回之傳輸句柄的值。

[in, optional] lParam

此參數所包含的值意義取決於 dwMessageId 參數。

[in, optional] pvUserData

WdsCliTransferImage 或 WdsCliTransferFile 函式附加至此會話之選擇性使用者資訊的指標。

傳回值

無

備註

回呼函式可以呼叫 WdsCliCancelTransfer 函式來取消傳輸。 雖然回呼函式也可以呼叫 WdsCliWaitForTransfer 函式，但不建議這麼做，因為除非解除封鎖目前的回呼，否則不會收到其他回呼。

規格需求

需求 值
最低支援的用戶端 具有SP1的 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wdsclientapi.h