ReactOS  r75400
obfuncs.h
Go to the documentation of this file.
1 $if (_WDMDDK_)
2 /******************************************************************************
3  * Object Manager Functions *
4  ******************************************************************************/
5 $endif (_WDMDDK_)
6 
7 #if (NTDDI_VERSION >= NTDDI_WIN2K)
8 $if (_WDMDDK_)
9 _IRQL_requires_max_(DISPATCH_LEVEL)
10 NTKERNELAPI
11 LONG_PTR
12 FASTCALL
13 ObfDereferenceObject(
14  _In_ PVOID Object);
15 #define ObDereferenceObject ObfDereferenceObject
16 
17 _IRQL_requires_max_(APC_LEVEL)
18 NTKERNELAPI
19 NTSTATUS
20 NTAPI
21 ObGetObjectSecurity(
22  _In_ PVOID Object,
23  _Out_ PSECURITY_DESCRIPTOR *SecurityDescriptor,
24  _Out_ PBOOLEAN MemoryAllocated);
25 
26 _IRQL_requires_max_(DISPATCH_LEVEL)
27 NTKERNELAPI
28 LONG_PTR
29 FASTCALL
30 ObfReferenceObject(
31  _In_ PVOID Object);
32 #define ObReferenceObject ObfReferenceObject
33 
34 _IRQL_requires_max_(APC_LEVEL)
35 NTKERNELAPI
36 NTSTATUS
37 NTAPI
38 ObReferenceObjectByHandle(
39  _In_ HANDLE Handle,
40  _In_ ACCESS_MASK DesiredAccess,
41  _In_opt_ POBJECT_TYPE ObjectType,
42  _In_ KPROCESSOR_MODE AccessMode,
43  _Out_ PVOID *Object,
44  _Out_opt_ POBJECT_HANDLE_INFORMATION HandleInformation);
45 
46 _IRQL_requires_max_(DISPATCH_LEVEL)
47 NTKERNELAPI
48 NTSTATUS
49 NTAPI
50 ObReferenceObjectByPointer(
51  _In_ PVOID Object,
52  _In_ ACCESS_MASK DesiredAccess,
53  _In_opt_ POBJECT_TYPE ObjectType,
54  _In_ KPROCESSOR_MODE AccessMode);
55 
56 _IRQL_requires_max_(APC_LEVEL)
57 NTKERNELAPI
58 VOID
59 NTAPI
60 ObReleaseObjectSecurity(
61  _In_ PSECURITY_DESCRIPTOR SecurityDescriptor,
62  _In_ BOOLEAN MemoryAllocated);
63 $endif (_WDMDDK_)
64 $if (_NTIFS_)
65 
66 NTKERNELAPI
67 NTSTATUS
68 NTAPI
69 ObInsertObject(
70  _In_ PVOID Object,
71  _Inout_opt_ PACCESS_STATE PassedAccessState,
72  _In_opt_ ACCESS_MASK DesiredAccess,
73  _In_ ULONG ObjectPointerBias,
74  _Out_opt_ PVOID *NewObject,
75  _Out_opt_ PHANDLE Handle);
76 
77 NTKERNELAPI
78 NTSTATUS
79 NTAPI
80 ObOpenObjectByPointer(
81  _In_ PVOID Object,
82  _In_ ULONG HandleAttributes,
83  _In_opt_ PACCESS_STATE PassedAccessState,
84  _In_ ACCESS_MASK DesiredAccess,
85  _In_opt_ POBJECT_TYPE ObjectType,
86  _In_ KPROCESSOR_MODE AccessMode,
87  _Out_ PHANDLE Handle);
88 
89 NTKERNELAPI
90 VOID
91 NTAPI
92 ObMakeTemporaryObject(
93  _In_ PVOID Object);
94 
95 NTKERNELAPI
96 NTSTATUS
97 NTAPI
98 ObQueryNameString(
99  _In_ PVOID Object,
100  _Out_writes_bytes_opt_(Length) POBJECT_NAME_INFORMATION ObjectNameInfo,
101  _In_ ULONG Length,
102  _Out_ PULONG ReturnLength);
103 
104 NTKERNELAPI
105 NTSTATUS
106 NTAPI
107 ObQueryObjectAuditingByHandle(
108  _In_ HANDLE Handle,
109  _Out_ PBOOLEAN GenerateOnClose);
110 $endif (_NTIFS_)
111 #endif /* (NTDDI_VERSION >= NTDDI_WIN2K) */
112 
113 #if (NTDDI_VERSION >= NTDDI_VISTA)
114 $if (_WDMDDK_)
115 NTKERNELAPI
116 VOID
117 NTAPI
118 ObDereferenceObjectDeferDelete(
119  _In_ PVOID Object);
120 $endif (_WDMDDK_)
121 $if (_NTIFS_)
122 
123 NTKERNELAPI
124 BOOLEAN
125 NTAPI
126 ObIsKernelHandle(
127  _In_ HANDLE Handle);
128 $endif (_NTIFS_)
129 #endif
130 
131 $if (_WDMDDK_)
132 #if (NTDDI_VERSION >= NTDDI_VISTASP1)
133 NTKERNELAPI
134 NTSTATUS
135 NTAPI
136 ObRegisterCallbacks(
137  _In_ POB_CALLBACK_REGISTRATION CallbackRegistration,
138  _Outptr_ PVOID *RegistrationHandle);
139 
140 NTKERNELAPI
141 VOID
142 NTAPI
143 ObUnRegisterCallbacks(
144  _In_ PVOID RegistrationHandle);
145 
146 NTKERNELAPI
147 USHORT
148 NTAPI
149 ObGetFilterVersion(VOID);
150 
151 #endif /* (NTDDI_VERSION >= NTDDI_VISTASP1) */
152 $endif (_WDMDDK_)
153 
154 #if (NTDDI_VERSION >= NTDDI_WIN7)
155 $if (_WDMDDK_)
156 _IRQL_requires_max_(APC_LEVEL)
157 NTKERNELAPI
158 NTSTATUS
159 NTAPI
160 ObReferenceObjectByHandleWithTag(
161  _In_ HANDLE Handle,
162  _In_ ACCESS_MASK DesiredAccess,
163  _In_opt_ POBJECT_TYPE ObjectType,
164  _In_ KPROCESSOR_MODE AccessMode,
165  _In_ ULONG Tag,
166  _Out_ PVOID *Object,
167  _Out_opt_ POBJECT_HANDLE_INFORMATION HandleInformation);
168 
169 _IRQL_requires_max_(DISPATCH_LEVEL)
170 NTKERNELAPI
171 LONG_PTR
172 FASTCALL
173 ObfReferenceObjectWithTag(
174  _In_ PVOID Object,
175  _In_ ULONG Tag);
176 
177 _IRQL_requires_max_(DISPATCH_LEVEL)
178 NTKERNELAPI
179 NTSTATUS
180 NTAPI
181 ObReferenceObjectByPointerWithTag(
182  _In_ PVOID Object,
183  _In_ ACCESS_MASK DesiredAccess,
184  _In_opt_ POBJECT_TYPE ObjectType,
185  _In_ KPROCESSOR_MODE AccessMode,
186  _In_ ULONG Tag);
187 
188 _IRQL_requires_max_(DISPATCH_LEVEL)
189 NTKERNELAPI
190 LONG_PTR
191 FASTCALL
192 ObfDereferenceObjectWithTag(
193  _In_ PVOID Object,
194  _In_ ULONG Tag);
195 
196 NTKERNELAPI
197 VOID
198 NTAPI
199 ObDereferenceObjectDeferDeleteWithTag(
200  _In_ PVOID Object,
201  _In_ ULONG Tag);
202 
203 #define ObDereferenceObject ObfDereferenceObject
204 #define ObReferenceObject ObfReferenceObject
205 #define ObDereferenceObjectWithTag ObfDereferenceObjectWithTag
206 #define ObReferenceObjectWithTag ObfReferenceObjectWithTag
207 $endif (_WDMDDK_)
208 $if (_NTIFS_)
209 
210 NTKERNELAPI
211 NTSTATUS
212 NTAPI
213 ObOpenObjectByPointerWithTag(
214  _In_ PVOID Object,
215  _In_ ULONG HandleAttributes,
216  _In_opt_ PACCESS_STATE PassedAccessState,
217  _In_ ACCESS_MASK DesiredAccess,
218  _In_opt_ POBJECT_TYPE ObjectType,
219  _In_ KPROCESSOR_MODE AccessMode,
220  _In_ ULONG Tag,
221  _Out_ PHANDLE Handle);
222 
223 NTKERNELAPI
224 ULONG
225 NTAPI
226 ObGetObjectPointerCount(
227  _In_ PVOID Object
228 );
229 
230 $endif (_NTIFS_)
231 #endif /* (NTDDI_VERSION >= NTDDI_WIN7) */
232 
_SECURITY_DESCRIPTOR
Definition: ms-dtyp.idl:301
ReturnLength
_In_ OBJECT_INFORMATION_CLASS _In_ ULONG _Out_opt_ PULONG ReturnLength
Definition: obfuncs.h:294
PVOID
DWORD *typedef PVOID
Definition: winlogon.h:52
ObfDereferenceObject
LONG_PTR FASTCALL ObfDereferenceObject(IN PVOID Object)
Definition: obref.c:212
ObGetFilterVersion
NTKERNELAPI USHORT NTAPI ObGetFilterVersion(VOID)
HandleAttributes
_In_ HANDLE _In_opt_ HANDLE _Out_opt_ PHANDLE _In_ ACCESS_MASK _In_ ULONG HandleAttributes
Definition: obfuncs.h:429
ObIsKernelHandle
BOOLEAN NTAPI ObIsKernelHandle(IN HANDLE Handle)
Definition: obhandle.c:3515
SecurityDescriptor
_In_ USHORT _In_ ULONG _In_ PSOCKADDR _In_ PSOCKADDR _Reserved_ ULONG _In_opt_ PVOID _In_opt_ const WSK_CLIENT_CONNECTION_DISPATCH _In_opt_ PEPROCESS _In_opt_ PETHREAD _In_opt_ PSECURITY_DESCRIPTOR SecurityDescriptor
Definition: wsk.h:182
ObOpenObjectByPointer
NTKERNELAPI NTSTATUS NTAPI ObOpenObjectByPointer(_In_ PVOID Object, _In_ ULONG HandleAttributes, _In_opt_ PACCESS_STATE PassedAccessState, _In_ ACCESS_MASK DesiredAccess, _In_opt_ POBJECT_TYPE ObjectType, _In_ KPROCESSOR_MODE AccessMode, _Out_ PHANDLE Handle)
MemoryAllocated
_Out_ PSECURITY_DESCRIPTOR _Out_ PBOOLEAN MemoryAllocated
Definition: obfuncs.h:23
_OBJECT_HANDLE_INFORMATION
Definition: iotypes.h:156
ObfReferenceObject
LONG_PTR FASTCALL ObfReferenceObject(IN PVOID Object)
Definition: obref.c:202
DesiredAccess
_In_ HANDLE _In_opt_ HANDLE _Out_opt_ PHANDLE _In_ ACCESS_MASK DesiredAccess
Definition: obfuncs.h:429
_NTIFS_
#define _NTIFS_
Definition: ifssupp.h:20
_Outptr_
#define _Outptr_
Definition: no_sal2.h:396
PassedAccessState
_Inout_opt_ PACCESS_STATE PassedAccessState
Definition: obfuncs.h:71
_WDMDDK_
#define _WDMDDK_
Definition: wdm.template.h:26
_OBJECT_NAME_INFORMATION
Definition: nt_native.h:1269
_OBJECT_TYPE
Definition: obtypes.h:379
FASTCALL
#define FASTCALL
Definition: nt_native.h:50
Object
_In_ ACCESS_MASK _In_opt_ POBJECT_TYPE _In_ KPROCESSOR_MODE _Out_ PVOID * Object
Definition: obfuncs.h:40
_In_opt_
#define _In_opt_
Definition: no_sal2.h:213
_IRQL_requires_max_
_IRQL_requires_max_(PASSIVE_LEVEL) __kernel_entry NTSYSCALLAPI NTSTATUS NTAPI NtQueryObject(_In_opt_ HANDLE Handle
Definition: Messaging.c:37
ObReferenceObjectByHandle
NTSTATUS NTAPI ObReferenceObjectByHandle(IN HANDLE Handle, IN ACCESS_MASK DesiredAccess, IN POBJECT_TYPE ObjectType, IN KPROCESSOR_MODE AccessMode, OUT PVOID *Object, OUT POBJECT_HANDLE_INFORMATION HandleInformation OPTIONAL)
Definition: obref.c:388
NTAPI
NTSTATUS(* NTAPI)(IN PFILE_FULL_EA_INFORMATION EaBuffer, IN ULONG EaLength, OUT PULONG ErrorOffset)
Definition: IoEaTest.cpp:117
ObReleaseObjectSecurity
VOID NTAPI ObReleaseObjectSecurity(IN PSECURITY_DESCRIPTOR SecurityDescriptor, IN BOOLEAN MemoryAllocated)
Definition: obsecure.c:709
_Out_
#define _Out_
Definition: no_sal2.h:323
NTKERNELAPI
#define NTKERNELAPI
ObReferenceObjectByPointer
NTSTATUS NTAPI ObReferenceObjectByPointer(IN PVOID Object, IN ACCESS_MASK DesiredAccess, IN POBJECT_TYPE ObjectType, IN KPROCESSOR_MODE AccessMode)
Definition: obref.c:275
ObGetObjectSecurity
NTSTATUS NTAPI ObGetObjectSecurity(IN PVOID Object, OUT PSECURITY_DESCRIPTOR *SecurityDescriptor, OUT PBOOLEAN MemoryAllocated)
Definition: obsecure.c:611
_Out_opt_
#define _Out_opt_
Definition: no_sal2.h:339
Handle
_In_ HANDLE Handle
Definition: extypes.h:390
BOOLEAN
unsigned char BOOLEAN
Definition: ProcessorBind.h:185
_Out_writes_bytes_opt_
_In_ OBJECT_INFORMATION_CLASS _Out_writes_bytes_opt_(ObjectInformationLength) PVOID ObjectInformation
_ACCESS_STATE
Definition: setypes.h:196
GenerateOnClose
_In_opt_ PVOID _In_opt_ PUNICODE_STRING _In_ PSECURITY_DESCRIPTOR _In_ PACCESS_STATE _In_ BOOLEAN _In_ BOOLEAN _In_ KPROCESSOR_MODE _In_opt_ GUID _Out_ PBOOLEAN GenerateOnClose
Definition: sefuncs.h:414
ObQueryObjectAuditingByHandle
NTKERNELAPI NTSTATUS NTAPI ObQueryObjectAuditingByHandle(_In_ HANDLE Handle, _Out_ PBOOLEAN GenerateOnClose)
HandleInformation
_In_ ACCESS_MASK _In_opt_ POBJECT_TYPE _In_ KPROCESSOR_MODE _Out_ PVOID _Out_opt_ POBJECT_HANDLE_INFORMATION HandleInformation
Definition: obfuncs.h:40
ObMakeTemporaryObject
NTKERNELAPI VOID NTAPI ObMakeTemporaryObject(_In_ PVOID Object)
KPROCESSOR_MODE
CCHAR KPROCESSOR_MODE
Definition: ketypes.h:7
$if
$if(_WDMDDK_)$endif(_WDMDDK_) $if(_WDMDDK_) _IRQL_requires_max_(DISPATCH_LEVEL) NTKERNELAPI LONG_PTR FASTCALL ObfDereferenceObject(_In_ PVOID Object)
Definition: ke.h:1
PBOOLEAN
char * PBOOLEAN
Definition: retypes.h:11
Length
VOID UINTN Length
Definition: acefiex.h:718
PHANDLE
PVOID *typedef PHANDLE
Definition: ntsecpkg.h:411
ObjectType
_In_ ACCESS_MASK _In_opt_ POBJECT_TYPE ObjectType
Definition: obfuncs.h:40
ObGetObjectPointerCount
NTKERNELAPI ULONG NTAPI ObGetObjectPointerCount(_In_ PVOID Object)
RegistrationHandle
_Outptr_ PVOID * RegistrationHandle
Definition: obfuncs.h:138
_OB_CALLBACK_REGISTRATION
Definition: obtypes.h:115
DISPATCH_LEVEL
#define DISPATCH_LEVEL
Definition: env_spec_w32.h:696
_In_
#define _In_
Definition: no_sal2.h:204
HANDLE
DWORD *typedef HANDLE
Definition: winlogon.h:52
ObInsertObject
NTSTATUS NTAPI ObInsertObject(IN PVOID Object, IN PACCESS_STATE AccessState OPTIONAL, IN ACCESS_MASK DesiredAccess, IN ULONG ObjectPointerBias, OUT PVOID *NewObject OPTIONAL, OUT PHANDLE Handle)
Definition: obhandle.c:2925
NTSTATUS
LONG NTSTATUS
Definition: DriverTester.h:11
USHORT
unsigned short USHORT
Definition: pedump.c:61
ObUnRegisterCallbacks
NTKERNELAPI VOID NTAPI ObUnRegisterCallbacks(_In_ PVOID RegistrationHandle)
ObQueryNameString
NTKERNELAPI NTSTATUS NTAPI ObQueryNameString(_In_ PVOID Object, _Out_writes_bytes_opt_(Length) POBJECT_NAME_INFORMATION ObjectNameInfo, _In_ ULONG Length, _Out_ PULONG ReturnLength)
$endif
$endif(_WDMDDK_) $if(_NTIFS_) NTKERNELAPI NTSTATUS NTAPI ObInsertObject(_In_ PVOID Object
Definition: ke.h:202
LONG_PTR
__int3264 LONG_PTR
Definition: mstsclib_h.h:276
PULONG
unsigned int * PULONG
Definition: retypes.h:1
Tag
IN ULONG IN ULONG Tag
Definition: evtlib.h:153
ULONG
unsigned int ULONG
Definition: retypes.h:1
NewObject
_Inout_opt_ PACCESS_STATE _In_opt_ ACCESS_MASK _In_ ULONG _Out_opt_ PVOID * NewObject
Definition: obfuncs.h:71
APC_LEVEL
#define APC_LEVEL
Definition: env_spec_w32.h:695
ACCESS_MASK
ULONG ACCESS_MASK
Definition: nt_native.h:40
ObDereferenceObjectDeferDelete
NTKERNELAPI VOID NTAPI ObDereferenceObjectDeferDelete(_In_ PVOID Object)
ObDereferenceObjectDeferDeleteWithTag
NTKERNELAPI VOID NTAPI ObDereferenceObjectDeferDeleteWithTag(_In_ PVOID Object, _In_ ULONG Tag)
ObjectPointerBias
_Inout_opt_ PACCESS_STATE _In_opt_ ACCESS_MASK _In_ ULONG ObjectPointerBias
Definition: obfuncs.h:71
_Inout_opt_
#define _Inout_opt_
Definition: no_sal2.h:258
AccessMode
_In_ ACCESS_MASK _In_opt_ POBJECT_TYPE _In_ KPROCESSOR_MODE AccessMode
Definition: obfuncs.h:40