SETRESULT_INFO Struktur (compstui.h)

Die SETRESULT_INFO-Struktur wird als Eingabeparameter für die PFNPROPSHEETUI-typisierte Rückruffunktion einer Anwendung verwendet.

Syntax

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

Member

cbSize

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

wReserved

Reserviert.

hSetResult

Von CPSUI bereitgestelltes Handle für eine hinzugefügte Eigenschaftenblattseite, die von der Anwendung abgerufen wird. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise .

Result

Von CPSUI bereitgestelltes Handle für eine hinzugefügte Eigenschaftenblattseite, die von der Anwendung abgerufen wird. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise .

Hinweise

Wenn eine Anwendung die ComPropSheet-Funktion von CPSUI aufruft und einen Funktionscode von CPSFUNC_SET_RESULT angibt, ruft CPSUI alle registrierten Funktionen vom Typ PFNPROPSHEETUI auf, wobei ein Grund für PROPSHEETUI_REASON_SET_RESULT angegeben wird. Wenn Sie diesen Grund angeben, stellt CPSUI auch eine SETRESULT_INFO-Struktur bereit.

Die Werte, die in den Elementen hSetResult und Result der Struktur enthalten sind, sind die Werte lParam1 bzw. lParam2 , die für die ComPropSheet-Funktion von CPSUI bereitgestellt wurden.

Jede der PFNPROPSHEETUI-typisierten Funktionen der Anwendung wird in der Reihenfolge aufgerufen, von der zuletzt deklarierten bis zur ersten deklarierten, bis eine dieser Funktionen einen Rückgabewert von kleiner als 1 bereitstellt. An diesem Punkt gibt CPSUI von seiner ComPropSheet-Funktion zurück und gibt eine Anzahl der aufgerufenen Funktionen vom Typ PFNPROPSHEETUI an.

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

Anforderungen

Anforderung	Wert
Header	compstui.h (einschließlich Compstui.h)