SetCPSUIUserData-Funktion (compstui.h)

Die SetCPSUIUserData-Funktion von CPSUI ermöglicht CPSUI-Anwendungen (einschließlich Druckerschnittstellen-DLLs), nicht angezeigte Daten einem Eigenschaftenblattdialogfeld zuzuordnen.

Syntax

BOOL SetCPSUIUserData(
  HWND      hDlg,
  ULONG_PTR CPSUIUserData
);

Parameter

hDlg

Vom Aufrufer bereitgestelltes Handle für ein Eigenschaftenblatt-Dialogfeld. Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten.

CPSUIUserData

Der vom Aufrufer bereitgestellte Wert, der gespeichert werden soll.

Rückgabewert

Die Funktion gibt TRUE- zurück, wenn die nicht angezeigten Daten dem Eigenschaftenblattdialogfeld zugeordnet werden, und FALSE andernfalls.

Bemerkungen

Die SetCPSUIUserData--Funktion sollte nur innerhalb einer Dialogfeldprozedur aufgerufen werden, die einem Dialogfeld zugeordnet wurde, indem ein DLGPAGE- oder eine EXTPUSH--Struktur verwendet wird.

Ein Wert, der durch Aufrufen von SetCPSUIUserData gespeichert wird, kann später durch Aufrufen von GetCPSUIUserDataabgerufen werden.

Das für hDlg- angegebene Handle muss das Handle sein, das als Eingabe in die Dialogfeldprozedurempfangen wird.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	compstui.h (include Compstui.h)
Library	Compstui.lib
DLL-	Compstui.dll