SetCPSUIUserData 函式 (compstui.h)

CPSUI 的 SetCPSUIUserData 函式可讓 CPSUI 應用程式 (包括列印機介面 DLL) ，以將非顯示的數據與屬性表對話框產生關聯。

語法

BOOL SetCPSUIUserData(
  HWND      hDlg,
  ULONG_PTR CPSUIUserData
);

hDlg

呼叫端提供給屬性表對話框的句柄。如需詳細資訊，請參閱下面的＜備註＞一節。

CPSUIUserData

要儲存的呼叫端提供值。

如果函式成功將未顯示的數據與屬性表對話框產生關聯，則函式會傳回 TRUE ，否則傳回 FALSE 。

只有使用 DLGPAGE 或 EXTPUSH 結構與對話框相關聯的對話框程式內，才應該呼叫 SetCPSUIUserData 函式。

呼叫 SetCPSUIUserData 所儲存的值稍後可以藉由呼叫 GetCPSUIUserData 來擷取。

為 hDlg 指定的句柄必須是接收做為對話框程式輸入的句柄。