ReactOS 0.4.15-dev-7906-g1b85a5f
guidobj.c
Go to the documentation of this file.
1/*
2 * PROJECT: ReactOS Kernel
3 * LICENSE: GPL - See COPYING in the top level directory
4 * FILE: ntoskrnl/wmi/guidobj.c
5 * PURPOSE: I/O Windows Management Instrumentation (WMI) Support
6 * PROGRAMMERS: Timo Kreuzer (timo.kreuzer@reactos.org)
7 */
8
9/* INCLUDES *****************************************************************/
10
11#include <ntoskrnl.h>
12#include <wmistr.h>
13#include "wmip.h"
14
15#define NDEBUG
16#include <debug.h>
17
18
19/* GLOBALS ******************************************************************/
20
23{
28};
29
30
31/* FUNCTIONS *****************************************************************/
32
37 _In_ SECURITY_OPERATION_CODE OperationType,
40 _Inout_ PULONG CapturedLength,
41 _Inout_ PSECURITY_DESCRIPTOR *ObjectSecurityDescriptor,
44{
45 PAGED_CODE();
46
48 ASSERT((OperationType == QuerySecurityDescriptor) ||
49 (OperationType == SetSecurityDescriptor) ||
50 (OperationType == AssignSecurityDescriptor) ||
51 (OperationType == DeleteSecurityDescriptor));
52
53 if (OperationType == QuerySecurityDescriptor)
54 {
58 CapturedLength,
59 ObjectSecurityDescriptor);
60 }
61 else if (OperationType == SetSecurityDescriptor)
62 {
66 ObjectSecurityDescriptor,
69 }
70 else if (OperationType == AssignSecurityDescriptor)
71 {
73 return STATUS_SUCCESS;
74 }
75 else if (OperationType == DeleteSecurityDescriptor)
76 {
77 return ObDeassignSecurity(ObjectSecurityDescriptor);
78 }
79
82}
83
84VOID
88{
89 PWMIP_GUID_OBJECT GuidObject = Object;
90
91 /* Check if the object is attached to an IRP */
92 if (GuidObject->Irp != NULL)
93 {
94 /* This is not supported yet */
96 }
97}
98
99VOID
100NTAPI
106 _In_ ULONG SystemHandleCount)
107{
108 /* For now nothing */
109}
110
112NTAPI
114 VOID)
115{
116 static UNICODE_STRING GuidObjectName = RTL_CONSTANT_STRING(L"WmiGuid");
117 OBJECT_TYPE_INITIALIZER ObjectTypeInitializer;
119
120 /* Setup the object type initializer */
121 RtlZeroMemory(&ObjectTypeInitializer, sizeof(ObjectTypeInitializer));
122 ObjectTypeInitializer.Length = sizeof(ObjectTypeInitializer);
123 ObjectTypeInitializer.InvalidAttributes = OBJ_OPENLINK;
124 ObjectTypeInitializer.GenericMapping = WmipGenericMapping;
125 ObjectTypeInitializer.PoolType = NonPagedPool;
126 ObjectTypeInitializer.MaintainHandleCount = FALSE;
127 ObjectTypeInitializer.ValidAccessMask = STANDARD_RIGHTS_ALL | 0xFFF;
128 ObjectTypeInitializer.SecurityRequired = TRUE;
129 ObjectTypeInitializer.DefaultNonPagedPoolCharge = sizeof(WMIP_GUID_OBJECT);
130 ObjectTypeInitializer.SecurityProcedure = WmipSecurityMethod;
131 ObjectTypeInitializer.DeleteProcedure = WmipDeleteMethod;
132 ObjectTypeInitializer.CloseProcedure = WmipCloseMethod;
133
134 /* Create the object type */
135 Status = ObCreateObjectType(&GuidObjectName,
136 &ObjectTypeInitializer,
137 0,
139 if (!NT_SUCCESS(Status))
140 {
141 DPRINT1("ObCreateObjectType failed: 0x%lx\n", Status);
142 }
143
144 return Status;
145}
146
147static
152{
155
156 /* Validate string length */
157 if (GuidString->Length != GUID_STRING_LENGTH * sizeof(WCHAR))
158 {
160 }
161
162 /* Copy the string and wrap it in {} */
163 RtlCopyMemory(&Buffer[1], GuidString->Buffer, GuidString->Length);
164 Buffer[0] = L'{';
165 Buffer[GUID_STRING_LENGTH + 1] = L'}';
166
167 String.Buffer = Buffer;
168 String.Length = String.MaximumLength = sizeof(Buffer);
169
170 return RtlGUIDFromString(&String, Guid);
171}
172
173static
176 _In_ const GUID *Guid,
177 _Out_ PWMIP_GUID_OBJECT *OutGuidObject)
178{
180 PWMIP_GUID_OBJECT GuidObject;
182
183 /* Initialize object attributes for an unnamed object */
185 NULL,
186 0,
187 NULL,
188 NULL); // FIXME: security descriptor!
189
190 /* Create the GUID object */
195 NULL,
196 sizeof(WMIP_GUID_OBJECT),
197 0,
198 0,
199 (PVOID*)&GuidObject);
200 if (!NT_SUCCESS(Status))
201 {
202 DPRINT1("WMI: failed to create GUID object: 0x%lx\n", Status);
203 return Status;
204 }
205
206 RtlZeroMemory(GuidObject, sizeof(*GuidObject));
208 GuidObject->Guid = *Guid;
209
210 *OutGuidObject = GuidObject;
211
212 return STATUS_SUCCESS;
213}
214
216NTAPI
221 _Out_ PHANDLE OutGuidObjectHandle,
222 _Outptr_ PVOID *OutGuidObject)
223{
224 PWMIP_GUID_OBJECT GuidObject;
227
228 /* Create the GUID object */
229 Status = WmipCreateGuidObject(Guid, &GuidObject);
230 if (!NT_SUCCESS(Status))
231 {
232 DPRINT1("Failed to create GUID object: 0x%lx\n", Status);
233 *OutGuidObject = NULL;
234 return Status;
235 }
236
237 /* Set handle attributes */
239
240 /* Get a handle for the object */
241 Status = ObOpenObjectByPointer(GuidObject,
243 0,
247 OutGuidObjectHandle);
248 if (!NT_SUCCESS(Status))
249 {
250 DPRINT1("ObOpenObjectByPointer failed: 0x%lx\n", Status);
251 ObDereferenceObject(GuidObject);
252 GuidObject = NULL;
253 }
254
255 *OutGuidObject = GuidObject;
256
257 return Status;
258}
259
261NTAPI
266 _Out_ PHANDLE OutGuidObjectHandle,
267 _Outptr_ PVOID *OutGuidObject)
268{
269 static UNICODE_STRING Prefix = RTL_CONSTANT_STRING(L"\\WmiGuid\\");
272 GUID Guid;
273 PAGED_CODE();
274
275 /* Check if we have the expected prefix */
277 {
278 DPRINT1("WMI: Invalid prefix for guid object '%wZ'\n",
279 ObjectAttributes->ObjectName);
281 }
282
283 /* Extract the GUID string */
284 GuidString = *ObjectAttributes->ObjectName;
285 GuidString.Buffer += Prefix.Length / sizeof(WCHAR);
286 GuidString.Length -= Prefix.Length;
287
288 /* Convert the string into a GUID structure */
290 if (!NT_SUCCESS(Status))
291 {
292 DPRINT1("WMI: Invalid uuid format for guid '%wZ'\n", &GuidString);
293 return Status;
294 }
295
296 return WmipOpenGuidObject(&Guid,
299 OutGuidObjectHandle,
300 OutGuidObject);
301}
302
#define PAGED_CODE()
static GENERIC_MAPPING GenericMapping
Definition: SeInheritance.c:11
LONG NTSTATUS
Definition: precomp.h:26
#define DPRINT1
Definition: precomp.h:8
Definition: bufpool.h:45
IN PUNICODE_STRING IN POBJECT_ATTRIBUTES ObjectAttributes
Definition: conport.c:36
#define NULL
Definition: types.h:112
#define TRUE
Definition: types.h:120
#define FALSE
Definition: types.h:117
#define NT_SUCCESS(StatCode)
Definition: apphelp.c:32
#define KeInitializeEvent(pEvt, foo, foo2)
Definition: env_spec_w32.h:477
#define NonPagedPool
Definition: env_spec_w32.h:307
#define PagedPool
Definition: env_spec_w32.h:308
_Must_inspect_result_ _In_ PFILE_OBJECT _In_ SECURITY_INFORMATION SecurityInformation
Definition: fltkernel.h:1340
_Must_inspect_result_ _In_ PLARGE_INTEGER _In_ PLARGE_INTEGER _In_ ULONG _In_ PFILE_OBJECT _In_ PVOID Process
Definition: fsrtlfuncs.h:223
Status
Definition: gdiplustypes.h:25
NTSTATUS NTAPI WmipInitializeGuidObjectType(VOID)
Definition: guidobj.c:113
VOID NTAPI WmipDeleteMethod(_In_ PVOID Object)
Definition: guidobj.c:86
VOID NTAPI WmipCloseMethod(_In_opt_ PEPROCESS Process, _In_ PVOID Object, _In_ ACCESS_MASK GrantedAccess, _In_ ULONG ProcessHandleCount, _In_ ULONG SystemHandleCount)
Definition: guidobj.c:101
NTSTATUS NTAPI WmipOpenGuidObjectByName(_In_ POBJECT_ATTRIBUTES ObjectAttributes, _In_ ACCESS_MASK DesiredAccess, _In_ KPROCESSOR_MODE AccessMode, _Out_ PHANDLE OutGuidObjectHandle, _Outptr_ PVOID *OutGuidObject)
Definition: guidobj.c:262
POBJECT_TYPE WmipGuidObjectType
Definition: guidobj.c:21
NTSTATUS NTAPI WmipOpenGuidObject(_In_ LPCGUID Guid, _In_ ACCESS_MASK DesiredAccess, _In_ KPROCESSOR_MODE AccessMode, _Out_ PHANDLE OutGuidObjectHandle, _Outptr_ PVOID *OutGuidObject)
Definition: guidobj.c:217
static NTSTATUS WmipCreateGuidObject(_In_ const GUID *Guid, _Out_ PWMIP_GUID_OBJECT *OutGuidObject)
Definition: guidobj.c:175
static NTSTATUS WmipGUIDFromString(_In_ PUNICODE_STRING GuidString, _Out_ PGUID Guid)
Definition: guidobj.c:149
GENERIC_MAPPING WmipGenericMapping
Definition: guidobj.c:22
NTSTATUS NTAPI WmipSecurityMethod(_In_ PVOID Object, _In_ SECURITY_OPERATION_CODE OperationType, _In_ PSECURITY_INFORMATION SecurityInformation, _In_ PSECURITY_DESCRIPTOR SecurityDescriptor, _Inout_ PULONG CapturedLength, _Inout_ PSECURITY_DESCRIPTOR *ObjectSecurityDescriptor, _In_ POOL_TYPE PoolType, _In_ PGENERIC_MAPPING GenericMapping)
Definition: guidobj.c:35
#define OBJ_KERNEL_HANDLE
Definition: winternl.h:231
#define OBJ_OPENLINK
Definition: winternl.h:230
NTSYSAPI NTSTATUS WINAPI RtlGUIDFromString(PUNICODE_STRING, GUID *)
@ ProcessHandleCount
Definition: winternl.h:876
#define ASSERT(a)
Definition: mode.c:44
static PWSTR GuidString
Definition: apphelp.c:93
#define InitializeObjectAttributes(p, n, a, r, s)
Definition: reg.c:106
DWORD * PSECURITY_INFORMATION
Definition: ms-dtyp.idl:311
#define _Inout_
Definition: ms_sal.h:378
#define _Outptr_
Definition: ms_sal.h:427
#define _Out_
Definition: ms_sal.h:345
#define _In_
Definition: ms_sal.h:308
#define _In_opt_
Definition: ms_sal.h:309
#define KernelMode
Definition: asm.h:34
_In_ HANDLE _In_opt_ HANDLE _Out_opt_ PHANDLE _In_ ACCESS_MASK _In_ ULONG HandleAttributes
Definition: obfuncs.h:433
ULONG ACCESS_MASK
Definition: nt_native.h:40
#define STANDARD_RIGHTS_ALL
Definition: nt_native.h:69
NTSYSAPI BOOLEAN NTAPI RtlPrefixUnicodeString(IN PUNICODE_STRING String1, IN PUNICODE_STRING String2, IN BOOLEAN CaseInSensitive)
@ NotificationEvent
PVOID *typedef PHANDLE
Definition: ntsecpkg.h:455
#define L(x)
Definition: ntvdm.h:50
NTSTATUS NTAPI ObDeassignSecurity(IN OUT PSECURITY_DESCRIPTOR *SecurityDescriptor)
Definition: obsecure.c:60
NTSTATUS NTAPI ObAssignObjectSecurityDescriptor(IN PVOID Object, IN PSECURITY_DESCRIPTOR SecurityDescriptor OPTIONAL, IN POOL_TYPE PoolType)
Definition: obsecure.c:20
NTSTATUS NTAPI ObSetSecurityDescriptorInfo(IN PVOID Object, IN PSECURITY_INFORMATION SecurityInformation, IN OUT PSECURITY_DESCRIPTOR SecurityDescriptor, IN OUT PSECURITY_DESCRIPTOR *OutputSecurityDescriptor, IN POOL_TYPE PoolType, IN PGENERIC_MAPPING GenericMapping)
Definition: obsecure.c:117
NTSTATUS NTAPI ObQuerySecurityDescriptorInfo(IN PVOID Object, IN PSECURITY_INFORMATION SecurityInformation, OUT PSECURITY_DESCRIPTOR SecurityDescriptor, IN OUT PULONG Length, IN PSECURITY_DESCRIPTOR *OutputSecurityDescriptor)
Definition: obsecure.c:85
NTSTATUS NTAPI ObOpenObjectByPointer(IN PVOID Object, IN ULONG HandleAttributes, IN PACCESS_STATE PassedAccessState, IN ACCESS_MASK DesiredAccess, IN POBJECT_TYPE ObjectType, IN KPROCESSOR_MODE AccessMode, OUT PHANDLE Handle)
Definition: obhandle.c:2742
NTSTATUS NTAPI ObCreateObject(IN KPROCESSOR_MODE ProbeMode OPTIONAL, IN POBJECT_TYPE Type, IN POBJECT_ATTRIBUTES ObjectAttributes OPTIONAL, IN KPROCESSOR_MODE AccessMode, IN OUT PVOID ParseContext OPTIONAL, IN ULONG ObjectSize, IN ULONG PagedPoolCharge OPTIONAL, IN ULONG NonPagedPoolCharge OPTIONAL, OUT PVOID *Object)
Definition: oblife.c:1039
NTSTATUS NTAPI ObCreateObjectType(IN PUNICODE_STRING TypeName, IN POBJECT_TYPE_INITIALIZER ObjectTypeInitializer, IN PVOID Reserved, OUT POBJECT_TYPE *ObjectType)
Definition: oblife.c:1136
#define STATUS_SUCCESS
Definition: shellext.h:65
OB_CLOSE_METHOD CloseProcedure
Definition: obtypes.h:368
OB_SECURITY_METHOD SecurityProcedure
Definition: obtypes.h:371
GENERIC_MAPPING GenericMapping
Definition: obtypes.h:358
OB_DELETE_METHOD DeleteProcedure
Definition: obtypes.h:369
BOOLEAN MaintainHandleCount
Definition: obtypes.h:361
ULONG DefaultNonPagedPoolCharge
Definition: obtypes.h:365
unsigned short Length
Definition: sprintf.c:451
KEVENT Event
Definition: wmip.h:15
#define RTL_CONSTANT_STRING(s)
Definition: tunneltest.c:14
uint32_t * PULONG
Definition: typedefs.h:59
INT POOL_TYPE
Definition: typedefs.h:78
#define NTAPI
Definition: typedefs.h:36
#define RtlCopyMemory(Destination, Source, Length)
Definition: typedefs.h:263
#define RtlZeroMemory(Destination, Length)
Definition: typedefs.h:262
uint32_t ULONG
Definition: typedefs.h:59
#define STATUS_INVALID_PARAMETER
Definition: udferr_usr.h:135
_Must_inspect_result_ _In_ WDFCOLLECTION _In_ WDFOBJECT Object
_Must_inspect_result_ _In_ WDFDEVICE _In_ ULONG _In_ ACCESS_MASK DesiredAccess
Definition: wdfdevice.h:2658
_Must_inspect_result_ _In_ WDFDEVICE _In_ DEVICE_REGISTRY_PROPERTY _In_ _Strict_type_match_ POOL_TYPE PoolType
Definition: wdfdevice.h:3815
_Must_inspect_result_ _In_ WDFDEVICE _In_ WDFSTRING String
Definition: wdfdevice.h:2433
_Must_inspect_result_ _In_ WDFOBJECT _In_ CONST GUID * Guid
Definition: wdfobject.h:762
#define GUID_STRING_LENGTH
Definition: wmip.h:6
struct _WMIP_GUID_OBJECT WMIP_GUID_OBJECT
#define WMIGUID_EXECUTE
Definition: wmistr.h:163
#define WMIGUID_ALL_ACCESS
Definition: wmistr.h:173
#define WMIGUID_QUERY
Definition: wmistr.h:159
#define WMIGUID_SET
Definition: wmistr.h:160
_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:191
CCHAR KPROCESSOR_MODE
Definition: ketypes.h:7
_In_ PEPROCESS _In_ KPROCESSOR_MODE AccessMode
Definition: mmfuncs.h:396
#define ObDereferenceObject
Definition: obfuncs.h:203
_In_ __drv_aliasesMem PSTRING Prefix
Definition: rtlfuncs.h:1630
_In_ PSECURITY_SUBJECT_CONTEXT _In_ BOOLEAN _In_ ACCESS_MASK _In_ ACCESS_MASK _Outptr_opt_ PPRIVILEGE_SET _In_ PGENERIC_MAPPING _In_ KPROCESSOR_MODE _Out_ PACCESS_MASK GrantedAccess
Definition: sefuncs.h:20
SECURITY_OPERATION_CODE
Definition: setypes.h:170
__wchar_t WCHAR
Definition: xmlstorage.h:180