ReactOS 0.4.17-dev-243-g1369312
Macros | Functions
ppb.c File Reference
#include <rtl.h>
#include <debug.h>
Include dependency graph for ppb.c:

Go to the source code of this file.

Macros

#define NDEBUG
 
#define NORMALIZE(x, addr)   {if(x) x=(PVOID)((ULONG_PTR)(x)+(ULONG_PTR)(addr));}
 
#define DENORMALIZE(x, addr)   {if(x) x=(PVOID)((ULONG_PTR)(x)-(ULONG_PTR)(addr));}
 
#define ALIGN(x, align)   (((ULONG)(x)+(align)-1UL)&(~((align)-1UL)))
 

Functions

static __inline VOID RtlpCopyParameterString (PWCHAR *Ptr, PUNICODE_STRING Destination, PUNICODE_STRING Source, USHORT Size)
 
NTSTATUS NTAPI RtlCreateProcessParameters (PRTL_USER_PROCESS_PARAMETERS *ProcessParameters, PUNICODE_STRING ImagePathName, PUNICODE_STRING DllPath, PUNICODE_STRING CurrentDirectory, PUNICODE_STRING CommandLine, PWSTR Environment, PUNICODE_STRING WindowTitle, PUNICODE_STRING DesktopInfo, PUNICODE_STRING ShellInfo, PUNICODE_STRING RuntimeData)
 
NTSTATUS NTAPI RtlDestroyProcessParameters (IN PRTL_USER_PROCESS_PARAMETERS ProcessParameters)
 
PRTL_USER_PROCESS_PARAMETERS NTAPI RtlDeNormalizeProcessParams (PRTL_USER_PROCESS_PARAMETERS Params)
 
PRTL_USER_PROCESS_PARAMETERS NTAPI RtlNormalizeProcessParams (PRTL_USER_PROCESS_PARAMETERS Params)
 

Macro Definition Documentation

◆ ALIGN

#define ALIGN (   x,
  align 
)    (((ULONG)(x)+(align)-1UL)&(~((align)-1UL)))

Definition at line 20 of file ppb.c.

◆ DENORMALIZE

#define DENORMALIZE (   x,
  addr 
)    {if(x) x=(PVOID)((ULONG_PTR)(x)-(ULONG_PTR)(addr));}

Definition at line 19 of file ppb.c.

◆ NDEBUG

#define NDEBUG

Definition at line 13 of file ppb.c.

◆ NORMALIZE

#define NORMALIZE (   x,
  addr 
)    {if(x) x=(PVOID)((ULONG_PTR)(x)+(ULONG_PTR)(addr));}

Definition at line 18 of file ppb.c.

Function Documentation

◆ RtlCreateProcessParameters()

NTSTATUS NTAPI RtlCreateProcessParameters ( PRTL_USER_PROCESS_PARAMETERS *  ProcessParameters,
PUNICODE_STRING  ImagePathName,
PUNICODE_STRING  DllPath,
PUNICODE_STRING  CurrentDirectory,
PUNICODE_STRING  CommandLine,
PWSTR  Environment,
PUNICODE_STRING  WindowTitle,
PUNICODE_STRING  DesktopInfo,
PUNICODE_STRING  ShellInfo,
PUNICODE_STRING  RuntimeData 
)

Definition at line 49 of file ppb.c.

59{
60 PRTL_USER_PROCESS_PARAMETERS Param = NULL;
61 ULONG Length = 0;
62 SIZE_T EnvironmentSize = 0;
63 ULONG AllocationSize;
64 PWCHAR Dest;
65 UNICODE_STRING EmptyString = { .Length = 0, .MaximumLength = sizeof(WCHAR), .Buffer = L"" }; ;
66 UNICODE_STRING NullString = { .Length = 0, .MaximumLength = 0, .Buffer = NULL }; ;
67 HANDLE CurrentDirectoryHandle;
68 HANDLE ConsoleHandle;
69 ULONG ConsoleFlags;
70
71 DPRINT ("RtlCreateProcessParameters\n");
72
73 RtlAcquirePebLock();
74
75 if (RtlpGetMode() == UserMode)
76 {
77 if (DllPath == NULL)
78 DllPath = &NtCurrentPeb()->ProcessParameters->DllPath;
79 if (Environment == NULL)
80 Environment = NtCurrentPeb()->ProcessParameters->Environment;
81 if (CurrentDirectory == NULL)
82 CurrentDirectory = &NtCurrentPeb()->ProcessParameters->CurrentDirectory.DosPath;
83 CurrentDirectoryHandle = NtCurrentPeb()->ProcessParameters->CurrentDirectory.Handle;
84 ConsoleHandle = NtCurrentPeb()->ProcessParameters->ConsoleHandle;
85 ConsoleFlags = NtCurrentPeb()->ProcessParameters->ConsoleFlags;
86 }
87 else
88 {
89 if (DllPath == NULL)
90 DllPath = &EmptyString;
91 if (CurrentDirectory == NULL)
92 CurrentDirectory = &EmptyString;
93 CurrentDirectoryHandle = NULL;
94 ConsoleHandle = NULL;
95 ConsoleFlags = 0;
96 }
97
98 if (CommandLine == NULL)
99 CommandLine = ImagePathName;
100 if (CommandLine == NULL)
101 CommandLine = &EmptyString;
102 if (WindowTitle == NULL)
103 WindowTitle = &EmptyString;
104 if (DesktopInfo == NULL)
105 DesktopInfo = &EmptyString;
106 if (ShellInfo == NULL)
107 ShellInfo = &EmptyString;
108 if (RuntimeData == NULL)
109 RuntimeData = &NullString;
110
111 /* size of process parameter block */
112 Length = sizeof(RTL_USER_PROCESS_PARAMETERS);
113
114 /* size of current directory buffer */
115 Length += (MAX_PATH * sizeof(WCHAR));
116
117 /* add string lengths */
118 Length += ALIGN(DllPath->MaximumLength, sizeof(PVOID));
119 Length += ALIGN(ImagePathName->Length + sizeof(WCHAR), sizeof(PVOID));
120 Length += ALIGN(CommandLine->Length + sizeof(WCHAR), sizeof(PVOID));
121 Length += ALIGN(WindowTitle->MaximumLength, sizeof(PVOID));
122 Length += ALIGN(DesktopInfo->MaximumLength, sizeof(PVOID));
123 Length += ALIGN(ShellInfo->MaximumLength, sizeof(PVOID));
124 Length += ALIGN(RuntimeData->MaximumLength, sizeof(PVOID));
125
126 /* Vista stores the EnvironmentSize in RTL_PROCESS_PARAMETERS */
127 if (Environment != NULL)
128 {
129 PWCHAR EnvEnd = Environment;
130 while (*EnvEnd)
131 EnvEnd += wcslen(EnvEnd) + 1;
132 EnvironmentSize = (EnvEnd - Environment + 1) * sizeof(WCHAR);
133 }
134
135 AllocationSize = Length + EnvironmentSize;
136
137 /* Calculate the required block size */
138 Param = RtlAllocateHeap(RtlGetProcessHeap(), HEAP_ZERO_MEMORY, AllocationSize);
139 if (!Param)
140 {
141 RtlReleasePebLock();
142 return STATUS_INSUFFICIENT_RESOURCES;
143 }
144
145 DPRINT ("Process parameters allocated\n");
146
147 Param->MaximumLength = Length;
148 Param->Length = Length;
149 Param->Flags = RTL_USER_PROCESS_PARAMETERS_NORMALIZED;
150 Param->Environment = NULL;
151 Param->EnvironmentSize = 0;
152 Param->CurrentDirectory.Handle = CurrentDirectoryHandle;
153 Param->ConsoleHandle = ConsoleHandle;
154 Param->ConsoleFlags = ConsoleFlags;
155
156 Dest = (PWCHAR)(((PBYTE)Param) + sizeof(RTL_USER_PROCESS_PARAMETERS));
157
158 /* copy current directory */
159 RtlpCopyParameterString(&Dest,
160 &Param->CurrentDirectory.DosPath,
161 CurrentDirectory,
162 MAX_PATH * sizeof(WCHAR));
163
164 /* make sure the current directory has a trailing backslash */
165 if (Param->CurrentDirectory.DosPath.Length > 0)
166 {
167 Length = Param->CurrentDirectory.DosPath.Length / sizeof(WCHAR);
168 if (Param->CurrentDirectory.DosPath.Buffer[Length-1] != L'\\')
169 {
170 Param->CurrentDirectory.DosPath.Buffer[Length] = L'\\';
171 Param->CurrentDirectory.DosPath.Buffer[Length + 1] = 0;
172 Param->CurrentDirectory.DosPath.Length += sizeof(WCHAR);
173 }
174 }
175
176 /* copy dll path */
177 RtlpCopyParameterString(&Dest,
178 &Param->DllPath,
179 DllPath,
180 0);
181
182 /* copy image path name */
183 RtlpCopyParameterString(&Dest,
184 &Param->ImagePathName,
185 ImagePathName,
186 ImagePathName->Length + sizeof(WCHAR));
187
188 /* copy command line */
189 RtlpCopyParameterString(&Dest,
190 &Param->CommandLine,
191 CommandLine,
192 CommandLine->Length + sizeof(WCHAR));
193
194 /* copy title */
195 RtlpCopyParameterString(&Dest,
196 &Param->WindowTitle,
197 WindowTitle,
198 0);
199
200 /* copy desktop */
201 RtlpCopyParameterString(&Dest,
202 &Param->DesktopInfo,
203 DesktopInfo,
204 0);
205
206 /* copy shell info */
207 RtlpCopyParameterString(&Dest,
208 &Param->ShellInfo,
209 ShellInfo,
210 0);
211
212 /* copy runtime info */
213 RtlpCopyParameterString(&Dest,
214 &Param->RuntimeData,
215 RuntimeData,
216 0);
217
218 /* Make sure we didn't go past the end of the buffer */
219 ASSERT(((PUCHAR)Dest - (PUCHAR)Param) <= Param->MaximumLength);
220
221 /* Copy the environment */
222 if (Environment != NULL)
223 {
224 RtlCopyMemory(Dest, Environment, EnvironmentSize);
225 Param->Environment = Dest;
226 Param->EnvironmentSize = EnvironmentSize;
227
228 /* Make sure we didn't go past the end of the buffer */
229 ASSERT((PUCHAR)Dest + EnvironmentSize - (PUCHAR)Param <= AllocationSize);
230 }
231
232 RtlDeNormalizeProcessParams(Param);
233 *ProcessParameters = Param;
234 RtlReleasePebLock();
235
236 return STATUS_SUCCESS;
237}
NtCurrentPeb
#define NtCurrentPeb()
Definition: FLS.c:22
CurrentDirectory
WCHAR CurrentDirectory[1024]
Definition: chkdsk.c:74
RtlAllocateHeap
PVOID NTAPI RtlAllocateHeap(IN PVOID HeapHandle, IN ULONG Flags, IN SIZE_T Size)
Definition: heap.c:616
RTL_USER_PROCESS_PARAMETERS
struct _RTL_USER_PROCESS_PARAMETERS RTL_USER_PROCESS_PARAMETERS
Buffer
Definition: bufpool.h:45
NULL
#define NULL
Definition: types.h:112
RtlpGetMode
KPROCESSOR_MODE NTAPI RtlpGetMode(VOID)
Definition: libsupp.c:55
MAX_PATH
#define MAX_PATH
Definition: compat.h:34
HEAP_ZERO_MEMORY
#define HEAP_ZERO_MEMORY
Definition: compat.h:134
wcslen
_ACRTIMP size_t __cdecl wcslen(const wchar_t *)
Definition: wcs.c:2983
L
#define L(x)
Definition: resources.c:13
AllocationSize
IN PFCB IN PFILE_OBJECT FileObject IN ULONG AllocationSize
Definition: fatprocs.h:323
ASSERT
#define ASSERT(a)
Definition: mode.c:44
Environment
PVOID PVOID PWCHAR PVOID Environment
Definition: env.c:47
DllPath
static const char const char * DllPath
Definition: image.c:34
UserMode
#define UserMode
Definition: asm.h:39
RTL_USER_PROCESS_PARAMETERS_NORMALIZED
#define RTL_USER_PROCESS_PARAMETERS_NORMALIZED
Definition: rtltypes.h:41
Length
_In_ ULONG _In_ ULONG _In_ ULONG Length
Definition: ntddpcm.h:102
PBYTE
BYTE * PBYTE
Definition: pedump.c:66
WCHAR
short WCHAR
Definition: pedump.c:58
RtlpCopyParameterString
static __inline VOID RtlpCopyParameterString(PWCHAR *Ptr, PUNICODE_STRING Destination, PUNICODE_STRING Source, USHORT Size)
Definition: ppb.c:26
ALIGN
#define ALIGN(x, align)
Definition: ppb.c:20
RtlDeNormalizeProcessParams
PRTL_USER_PROCESS_PARAMETERS NTAPI RtlDeNormalizeProcessParams(PRTL_USER_PROCESS_PARAMETERS Params)
Definition: ppb.c:256
STATUS_SUCCESS
#define STATUS_SUCCESS
Definition: shellext.h:65
DPRINT
#define DPRINT
Definition: sndvol32.h:73
_CURDIR::Handle
HANDLE Handle
Definition: rtltypes.h:1363
_RTL_USER_PROCESS_PARAMETERS
Definition: btrfs_drv.h:1898
_RTL_USER_PROCESS_PARAMETERS::ConsoleHandle
HANDLE ConsoleHandle
Definition: rtltypes.h:1554
_RTL_USER_PROCESS_PARAMETERS::MaximumLength
ULONG MaximumLength
Definition: rtltypes.h:1550
_RTL_USER_PROCESS_PARAMETERS::EnvironmentSize
SIZE_T EnvironmentSize
Definition: rtltypes.h:1579
_RTL_USER_PROCESS_PARAMETERS::CurrentDirectory
CURDIR CurrentDirectory
Definition: rtltypes.h:1559
_RTL_USER_PROCESS_PARAMETERS::ConsoleFlags
ULONG ConsoleFlags
Definition: rtltypes.h:1555
_RTL_USER_PROCESS_PARAMETERS::Flags
ULONG Flags
Definition: rtltypes.h:1552
_RTL_USER_PROCESS_PARAMETERS::Length
ULONG Length
Definition: rtltypes.h:1551
_RTL_USER_PROCESS_PARAMETERS::Environment
PWSTR Environment
Definition: rtltypes.h:1563
_UNICODE_STRING
Definition: env_spec_w32.h:368
_UNICODE_STRING::Length
USHORT Length
Definition: env_spec_w32.h:369
_UNICODE_STRING::MaximumLength
USHORT MaximumLength
Definition: env_spec_w32.h:370
SIZE_T
ULONG_PTR SIZE_T
Definition: typedefs.h:80
RtlCopyMemory
#define RtlCopyMemory(Destination, Source, Length)
Definition: typedefs.h:263
PWCHAR
uint16_t * PWCHAR
Definition: typedefs.h:56
PUCHAR
unsigned char * PUCHAR
Definition: typedefs.h:53
ULONG
uint32_t ULONG
Definition: typedefs.h:59
STATUS_INSUFFICIENT_RESOURCES
#define STATUS_INSUFFICIENT_RESOURCES
Definition: udferr_usr.h:158
RtlReleasePebLock
NTSYSAPI void WINAPI RtlReleasePebLock(void)
Definition: libsupp.c:84
RtlAcquirePebLock
NTSYSAPI void WINAPI RtlAcquirePebLock(void)
Definition: libsupp.c:74

◆ RtlDeNormalizeProcessParams()

PRTL_USER_PROCESS_PARAMETERS NTAPI RtlDeNormalizeProcessParams ( PRTL_USER_PROCESS_PARAMETERS  Params)

Definition at line 256 of file ppb.c.

257{
258 if (Params && (Params->Flags & RTL_USER_PROCESS_PARAMETERS_NORMALIZED))
259 {
260 DENORMALIZE(Params->CurrentDirectory.DosPath.Buffer, Params);
261 DENORMALIZE(Params->DllPath.Buffer, Params);
262 DENORMALIZE(Params->ImagePathName.Buffer, Params);
263 DENORMALIZE(Params->CommandLine.Buffer, Params);
264 DENORMALIZE(Params->WindowTitle.Buffer, Params);
265 DENORMALIZE(Params->DesktopInfo.Buffer, Params);
266 DENORMALIZE(Params->ShellInfo.Buffer, Params);
267 DENORMALIZE(Params->RuntimeData.Buffer, Params);
268
269 Params->Flags &= ~RTL_USER_PROCESS_PARAMETERS_NORMALIZED;
270 }
271
272 return Params;
273}
DENORMALIZE
#define DENORMALIZE(x, addr)
Definition: ppb.c:19
Params
_In_ WDFIOTARGET _In_ PWDF_REQUEST_COMPLETION_PARAMS Params
Definition: wdfrequest.h:308

Referenced by RtlCreateProcessParameters().

◆ RtlDestroyProcessParameters()

NTSTATUS NTAPI RtlDestroyProcessParameters ( IN PRTL_USER_PROCESS_PARAMETERS  ProcessParameters)

Definition at line 244 of file ppb.c.

245{
246 RtlFreeHeap(RtlGetProcessHeap(), 0, ProcessParameters);
247 return STATUS_SUCCESS;
248}
RtlFreeHeap
BOOLEAN NTAPI RtlFreeHeap(IN PVOID HeapHandle, IN ULONG Flags, IN PVOID HeapBase)
Definition: heap.c:634

◆ RtlNormalizeProcessParams()

PRTL_USER_PROCESS_PARAMETERS NTAPI RtlNormalizeProcessParams ( PRTL_USER_PROCESS_PARAMETERS  Params)

Definition at line 281 of file ppb.c.

282{
283 if (Params && !(Params->Flags & RTL_USER_PROCESS_PARAMETERS_NORMALIZED))
284 {
285 NORMALIZE(Params->CurrentDirectory.DosPath.Buffer, Params);
286 NORMALIZE(Params->DllPath.Buffer, Params);
287 NORMALIZE(Params->ImagePathName.Buffer, Params);
288 NORMALIZE(Params->CommandLine.Buffer, Params);
289 NORMALIZE(Params->WindowTitle.Buffer, Params);
290 NORMALIZE(Params->DesktopInfo.Buffer, Params);
291 NORMALIZE(Params->ShellInfo.Buffer, Params);
292 NORMALIZE(Params->RuntimeData.Buffer, Params);
293
294 Params->Flags |= RTL_USER_PROCESS_PARAMETERS_NORMALIZED;
295 }
296
297 return Params;
298}
NORMALIZE
#define NORMALIZE(x, addr)
Definition: ppb.c:18

◆ RtlpCopyParameterString()

static __inline VOID RtlpCopyParameterString ( PWCHAR *  Ptr,
PUNICODE_STRING  Destination,
PUNICODE_STRING  Source,
USHORT  Size 
)
static

Definition at line 26 of file ppb.c.

30{
31 Destination->Length = Source->Length;
32 Destination->MaximumLength = Size ? Size : Source->MaximumLength;
33 if (Destination->MaximumLength != 0)
34 {
35 Destination->Buffer = (PWCHAR)(*Ptr);
36 if (Source->Length)
37 memmove (Destination->Buffer, Source->Buffer, Source->Length);
38 Destination->Buffer[Destination->Length / sizeof(WCHAR)] = 0;
39 }
40 *Ptr += Destination->MaximumLength/sizeof(WCHAR);
41 *Ptr = ALIGN_UP_POINTER_BY(*Ptr, sizeof(PVOID));
42}
Ptr
_Must_inspect_result_ _In_ PFSRTL_PER_STREAM_CONTEXT Ptr
Definition: fsrtlfuncs.h:898
memmove
#define memmove(s1, s2, n)
Definition: mkisofs.h:881
Source
_In_ UINT _In_ UINT _In_ PNDIS_PACKET Source
Definition: ndis.h:3169
Destination
_In_ PUNICODE_STRING _Inout_ PUNICODE_STRING Destination
Definition: rtlfuncs.h:3051
_UNICODE_STRING::Buffer
PWSTR Buffer
Definition: env_spec_w32.h:371
ALIGN_UP_POINTER_BY
#define ALIGN_UP_POINTER_BY(ptr, align)
Definition: umtypes.h:85
Size
_Must_inspect_result_ _In_ WDFDEVICE _In_ PWDF_DEVICE_PROPERTY_DATA _In_ DEVPROPTYPE _In_ ULONG Size
Definition: wdfdevice.h:4539

Referenced by RtlCreateProcessParameters().