You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/atl/notifyhandler.md
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,9 @@
1
1
---
2
-
title: "NotifyHandler"
3
-
ms.date: "11/04/2016"
4
-
ms.topic: "reference"
5
-
helpviewer_keywords: ["NotifyHandler function"]
2
+
title: NotifyHandler
3
+
ms.date: 11/04/2016
4
+
ms.topic: reference
5
+
helpviewer_keywords:
6
+
- NotifyHandler function
6
7
ms.assetid: 5ff953ec-de35-42bc-8b3c-d384d636c139
7
8
---
8
9
# NotifyHandler
@@ -24,7 +25,7 @@ LRESULT NotifyHandler(
24
25
The identifier of the control sending the message.
25
26
26
27
*pnmh*<br/>
27
-
Address of an [NMHDR](/windows/desktop/api/richedit/ns-richedit-_nmhdr) structure that contains the notification code and additional information. For some notification messages, this parameter points to a larger structure that has the `NMHDR` structure as its first member.
28
+
Address of an [NMHDR](/windows/desktop/api/richedit/ns-richedit-nmhdr) structure that contains the notification code and additional information. For some notification messages, this parameter points to a larger structure that has the `NMHDR` structure as its first member.
28
29
29
30
*bHandled*<br/>
30
31
The message map sets *bHandled* to TRUE before *NotifyHandler* is called. If *NotifyHandler* does not fully handle the message, it should set *bHandled* to **FALSE** to indicate the message needs further processing.
Specifies a [SECURITY_IMPERSONATION_LEVEL](/windows/desktop/api/winnt/ne-winnt-_security_impersonation_level) enumerated type that supplies the impersonation level of the new token.
213
+
Specifies a [SECURITY_IMPERSONATION_LEVEL](/windows/desktop/api/winnt/ne-winnt-security_impersonation_level) enumerated type that supplies the impersonation level of the new token.
166
214
167
215
### Return Value
168
216
@@ -232,7 +280,7 @@ Pointer to a null-terminated string that specifies the command line to execute.
232
280
Pointer to a [PROCESS_INFORMATION structure](/windows/win32/api/processthreadsapi/ns-processthreadsapi-process_information) that receives identification information about the new process.
233
281
234
282
*pStartupInfo*<br/>
235
-
Pointer to a [STARTUPINFO](/windows/desktop/api/processthreadsapi/ns-processthreadsapi-_startupinfoa) structure that specifies how the main window for the new process should appear.
283
+
Pointer to a [STARTUPINFO](/windows/desktop/api/processthreadsapi/ns-processthreadsapi-startupinfoa) structure that specifies how the main window for the new process should appear.
236
284
237
285
*dwCreationFlags*<br/>
238
286
Specifies additional flags that control the priority class and the creation of the process. See the Win32 function [CreateProcessAsUser](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-createprocessasusera) for a list of flags.
@@ -478,7 +526,7 @@ bool GetImpersonationLevel(
478
526
### Parameters
479
527
480
528
*pImpersonationLevel*<br/>
481
-
Pointer to a [SECURITY_IMPERSONATION_LEVEL](/windows/desktop/api/winnt/ne-winnt-_security_impersonation_level) enumeration type which will receive the impersonation level information.
529
+
Pointer to a [SECURITY_IMPERSONATION_LEVEL](/windows/desktop/api/winnt/ne-winnt-security_impersonation_level) enumeration type which will receive the impersonation level information.
Address of the [TOKEN_TYPE](/windows/desktop/api/winnt/ne-winnt-_token_type) variable that, on success, receives the type of the token.
779
+
Address of the [TOKEN_TYPE](/windows/desktop/api/winnt/ne-winnt-token_type) variable that, on success, receives the type of the token.
732
780
733
781
### Return Value
734
782
@@ -1003,7 +1051,7 @@ Indicates whether the access check is to be made against the security context of
1003
1051
If this parameter is FALSE, the access check is performed using the security context for the calling thread. If the thread is impersonating a client, this security context can be that of a client process. If this parameter is TRUE, the access check is made using the security context of the process for the calling thread.
1004
1052
1005
1053
*sil*<br/>
1006
-
Specifies a [SECURITY_IMPERSONATION_LEVEL](/windows/desktop/api/winnt/ne-winnt-_security_impersonation_level) enumerated type that supplies the impersonation level of the token.
1054
+
Specifies a [SECURITY_IMPERSONATION_LEVEL](/windows/desktop/api/winnt/ne-winnt-security_impersonation_level) enumerated type that supplies the impersonation level of the token.
1007
1055
1008
1056
### Return Value
1009
1057
@@ -1028,7 +1076,7 @@ bool PrivilegeCheck(
1028
1076
### Parameters
1029
1077
1030
1078
*RequiredPrivileges*<br/>
1031
-
Pointer to a [PRIVILEGE_SET](/windows/desktop/api/winnt/ns-winnt-_privilege_set) structure.
1079
+
Pointer to a [PRIVILEGE_SET](/windows/desktop/api/winnt/ns-winnt-privilege_set) structure.
1032
1080
1033
1081
*pbResult*<br/>
1034
1082
Pointer to a value the method sets to indicate whether any or all of the specified privilege are enabled in the `CAccessToken` object.
@@ -1039,7 +1087,7 @@ Returns TRUE on success, FALSE on failure.
1039
1087
1040
1088
### Remarks
1041
1089
1042
-
When `PrivilegeCheck` returns, the `Attributes` member of each [LUID_AND_ATTRIBUTES](/windows/desktop/api/winnt/ns-winnt-_luid_and_attributes) structure is set to SE_PRIVILEGE_USED_FOR_ACCESS if the corresponding privilege is enabled. This method calls the [PrivilegeCheck](/windows/desktop/api/securitybaseapi/nf-securitybaseapi-privilegecheck) Win32 function.
1090
+
When `PrivilegeCheck` returns, the `Attributes` member of each [LUID_AND_ATTRIBUTES](/windows/desktop/api/winnt/ns-winnt-luid_and_attributes) structure is set to SE_PRIVILEGE_USED_FOR_ACCESS if the corresponding privilege is enabled. This method calls the [PrivilegeCheck](/windows/desktop/api/securitybaseapi/nf-securitybaseapi-privilegecheck) Win32 function.
This typedef specifies the array type used to define the access-control entry (ACE) type-specific control flags. See the [ACE_HEADER](/windows/desktop/api/winnt/ns-winnt-_ace_header) definition for the complete list of possible flags.
123
+
This typedef specifies the array type used to define the access-control entry (ACE) type-specific control flags. See the [ACE_HEADER](/windows/desktop/api/winnt/ns-winnt-ace_header) definition for the complete list of possible flags.
This typedef specifies the array type used to define the nature of the access-control entry (ACE) objects, such as ACCESS_ALLOWED_ACE_TYPE or ACCESS_DENIED_ACE_TYPE. See the [ACE_HEADER](/windows/desktop/api/winnt/ns-winnt-_ace_header) definition for the complete list of possible types.
135
+
This typedef specifies the array type used to define the nature of the access-control entry (ACE) objects, such as ACCESS_ALLOWED_ACE_TYPE or ACCESS_DENIED_ACE_TYPE. See the [ACE_HEADER](/windows/desktop/api/winnt/ns-winnt-ace_header) definition for the complete list of possible types.
118
136
119
137
## <aname="cacl"></a> CAcl::CAcl
120
138
@@ -190,7 +208,7 @@ This method fills the array parameters with the details of every ACE object cont
190
208
191
209
The contents of each array correspond to each other, that is, the first element of the `CAccessMaskArray` array corresponds to the first element in the `CSidArray` array, and so on.
192
210
193
-
See [ACE_HEADER](/windows/desktop/api/winnt/ns-winnt-_ace_header) for more details on ACE types and flags.
211
+
See [ACE_HEADER](/windows/desktop/api/winnt/ns-winnt-ace_header) for more details on ACE types and flags.
194
212
195
213
## <aname="getaclentry"></a> CAcl::GetAclEntry
196
214
@@ -234,7 +252,7 @@ The inherited object type. This will be set to GUID_NULL if the inherited object
234
252
235
253
This method will retrieve all of the information about an individual ACE, providing more information than [CAcl::GetAclEntries](#getaclentries) alone makes available.
236
254
237
-
See [ACE_HEADER](/windows/desktop/api/winnt/ns-winnt-_ace_header) for more details on ACE types and flags.
255
+
See [ACE_HEADER](/windows/desktop/api/winnt/ns-winnt-ace_header) for more details on ACE types and flags.
0 commit comments