PSN_APPLY

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This notification message indicates that the user chose the OKor Apply Nowbutton and wants all changes to take effect. It is sent in the form of a WM_NOTIFYmessage.

PSN_APPLY
lppsn
= (LPPSHNOTIFY)
lParam;

Parameters

lppsn

Long pointer to a PSHNOTIFYstructure that contains information about the notification.

Return Values

Returns the PSNRET_INVALID_NOCHANGEPAGE value to prevent the changes from taking effect and to return the focus to the page, or the PSNRET_NOERROR value to accept the changes and allow the property sheet to be destroyed.

Remarks

The lParammember of this structure does not contain any information.

The PSHNOTIFYstructure contains an NMHDRstructure as its first member, hdr. The hwndFrommember of this NMHDRstructure contains the handle to the property sheet.

To set the return value, the dialog box procedure for the page must use the SetWindowLongfunction with the DWL_MSGRESULT value, and the dialog box procedure must return TRUE.

A page should not call the EndDialogfunction when processing this notification message.

The property sheet is destroyed if the user clicks the OKbutton and the application returns the PSNRET_NOERROR value in response to this notification.

To receive this notification, a page must set the DWL_MSGRESULT value to FALSE in response the PSN_KILLACTIVEnotification message.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Prsht.h

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.