PROPSHEETUI_INFO-Struktur (compstui.h)

Die PROPSHEETUI_INFO-Struktur wird als Eingabeparameter für PFNPROPSHEETUI-typisierte Funktionen verwendet.

Syntax

typedef struct _PROPSHEETUI_INFO {
  WORD            cbSize;
  WORD            Version;
  WORD            Flags;
  WORD            Reason;
  HANDLE          hComPropSheet;
  PFNCOMPROPSHEET pfnComPropSheet;
  LPARAM          lParamInit;
  ULONG_PTR       UserData;
  ULONG_PTR       Result;
} PROPSHEETUI_INFO, *PPROPSHEETUI_INFO;

Member

cbSize

Von CPSUI bereitgestellte Größe der PROPSHEETUI_INFO-Struktur in Byte.

Version

Von CPSUI bereitgestellte Versionsnummer der PROPSHEETUI_INFO-Struktur . Die aktuelle Versionsnummer wird durch PROPSHEETUI_INFO_VERSION in compstui.h definiert.

Flags

Von CPSUI bereitgestellte Bitflags. Das folgende Flag ist definiert:

Reason

Von CPSUI bereitgestellte Konstante, die die Aktion angibt, die auf dem Eigenschaftenblatt von der PFNPROPSHEETUI-typisierten Funktion ausgeführt werden soll, an die die PROPSHEETUI_INFO-Struktur übergeben wurde. Eine der folgenden Konstanten wird bereitgestellt:

• PROPSHEETUI_REASON_DESTROY

• PROPSHEETUI_REASON_GET_ICON

• PROPSHEETUI_REASON_GET_INFO_HEADER

• PROPSHEETUI_REASON_INIT

• PROPSHEETUI_REASON_SET_RESULT

Informationen zur Bedeutung der einzelnen Konstanten finden Sie im Abschnitt Hinweise der PFNPROPSHEETUI-Beschreibung .

hComPropSheet

Von CPSUI bereitgestelltes Handle für ein übergeordnetes Eigenschaftenblatt. Dieses Handle kann an die ComPropSheet-Funktion von CPSUI übergeben werden.

pfnComPropSheet

Adresse der ComPropSheet-Funktion von CPSUI.

lParamInit

Der Wert, der als lParam-Parameter für die zugeordnete PFNPROPSHEETUI-typisierte Funktion empfangen wurde, wenn die Funktion zum ersten Mal mit einem Reason of PROPSHEETUI_REASON_INIT aufgerufen wurde. Informationen dazu, was dieser Wert sein kann, finden Sie in der Beschreibung von PFNPROPSHEETUI.

Dieser Wert wird von CPSUI bereitgestellt und ist für alle Reason-Werte gültig.

UserData

Optionaler, privater Wert oder Zeiger, der von der zugeordneten PFNPROPSHEETUI-typisierten Funktion bereitgestellt wird und anfänglich von CPSUI auf null festgelegt wurde. Wenn die Funktion einen Wert in UserData speichert, bleibt der gespeicherte Wert oder Zeiger für nachfolgende Aufrufe der Funktion unverändert, es sei denn, die Funktion ändert sich.

Result

Ergebniswert, der von der zugeordneten PFNPROPSHEETUI-typisierten Funktion bereitgestellt wird, der anfänglich von CPSUI auf 0 festgelegt wird. Wenn die Funktion einen Ergebniswert in Result speichert, bleibt der gespeicherte Wert für nachfolgende Aufrufe der Funktion unverändert, es sei denn, die Funktion ändert sich.

Wenn die Adresse der pfnpropsheetUI-typisierten Funktion als Argument für CommonPropertySheetUI angegeben wurde, wird der letzte in Result gespeicherte Wert an CommonPropertySheetUI an der Stelle zurückgegeben, auf die das pResult-Argument verweist.

Anforderungen