SETRESULT_INFO Struktur (compstui.h)

Die SETRESULT_INFO Struktur wird als Eingabeparameter für die PFNPROPSHEETUI-typed callback function einer Anwendung verwendet.

Syntax

typedef struct _SETRESULT_INFO {
  WORD    cbSize;
  WORD    wReserved;
  HANDLE  hSetResult;
  LRESULT Result;
} SETRESULT_INFO, *PSETRESULT_INFO;

Angehörige

cbSize

CPSUI-bereitgestellte Größe in Bytes der SETRESULT_INFO-Struktur.

wReserved

Reserviert.

hSetResult

CPSUI-bereitgestellter Handle zu einer hinzugefügten Eigenschaftenblattseite, die von der Anwendung abgerufen wird. Weitere Informationen finden Sie im Abschnitt Anmerkungen weiter unten.

Result

CPSUI-bereitgestellter Handle zu einer hinzugefügten Eigenschaftenblattseite, die von der Anwendung abgerufen wird. Weitere Informationen finden Sie im Abschnitt Anmerkungen weiter unten.

Bemerkungen

Wenn eine Anwendung die ComPropSheet--Funktion von CPSUI aufruft und einen Funktionscode von CPSFUNC_SET_RESULTangibt, ruft CPSUI alle registrierten PFNPROPSHEETUI--typierten Funktionen auf und gibt einen Grund für PROPSHEETUI_REASON_SET_RESULT an. Wenn Sie diesen Grund angeben, liefert CPSUI auch eine SETRESULT_INFO Struktur.

Die In den hSetResult-- und Result- Membern der Struktur enthaltenen Werte sind die lParam1- und lParam2--Werte, die der ComPropSheet- funktion von CPSUI bereitgestellt wurden.

Jede der PFNPROPSHEETUI-Typ-Funktionen der Anwendung wird in der Reihenfolge aufgerufen, von der zuletzt für die erste deklarierte Funktion, bis eine dieser Funktionen einen Rückgabewert von weniger als einer bereitstellt. Zu diesem Zeitpunkt gibt CPSUI von der ComPropSheet--Funktion zurück und stellt eine Anzahl der aufgerufenen PFNPROPSHEETUI-Typfunktionen bereit.

In der Regel legt die PFNPROPSHEETUI-typierte Funktion einer Anwendung das Result Member seiner PROPSHEETUI_INFO Struktur auf den Wert fest, der im Result--Element der SETRESULT_INFO Struktur empfangen wird. Anschließend gibt die Funktion einen Wert von 1 (oder höher) zurück, sodass die nächste PFNPROPSHEETUI-typierte Funktion sie auch empfangen kann. Jede anschließend aufgerufene Funktion wird einer Seite zugeordnet, die das übergeordnete Element der Seite ist, die der zuletzt aufgerufenen Funktion zugeordnet ist. Eine Funktion kann den Inhalt der Result Members SETRESULT_INFO Struktur ändern, wodurch die funktionen, die übergeordneten Seiten zugeordnet sind, den neuen Wert erhalten.

Anforderungen

Anforderung	Wert
Header-	compstui.h (include Compstui.h)