[HEADERS]
[reactos.git] / reactos / include / ndk / rtlfuncs.h
index 7c3d100..debd1ee 100644 (file)
@@ -77,8 +77,8 @@ InsertTailList(
     ListHead->Blink = Entry;
 }
 
-BOOLEAN
 FORCEINLINE
+BOOLEAN
 IsListEmpty(
     IN const LIST_ENTRY * ListHead
 )
@@ -195,14 +195,14 @@ RtlConvertUlongToLuid(ULONG Ulong)
 #if DBG
 
 #define ASSERT( exp ) \
-    ((!(exp)) ? \
+    ((void)((!(exp)) ? \
         (RtlAssert( #exp, __FILE__, __LINE__, NULL ),FALSE) : \
-        TRUE)
+        TRUE))
 
 #define ASSERTMSG( msg, exp ) \
-    ((!(exp)) ? \
+    ((void)((!(exp)) ? \
         (RtlAssert( #exp, __FILE__, __LINE__, msg ),FALSE) : \
-        TRUE)
+        TRUE))
 
 #else
 
@@ -407,6 +407,13 @@ RtlNtStatusToDosError(
     IN NTSTATUS Status
 );
 
+NTSYSAPI
+ULONG
+NTAPI
+RtlNtStatusToDosErrorNoTeb(
+    IN NTSTATUS Status
+);
+
 NTSYSAPI
 VOID
 NTAPI
@@ -421,6 +428,7 @@ RtlRaiseException(
     IN PEXCEPTION_RECORD ExceptionRecord
 );
 
+DECLSPEC_NORETURN
 NTSYSAPI
 VOID
 NTAPI
@@ -448,6 +456,15 @@ RtlUnwind(
 //
 // Tracing Functions
 //
+NTSYSAPI
+ULONG
+NTAPI
+RtlWalkFrameChain(
+    OUT PVOID *Callers,
+    IN ULONG Count,
+    IN ULONG Flags
+);
+
 NTSYSAPI
 USHORT
 NTAPI
@@ -464,7 +481,7 @@ NTAPI
 RtlAllocateHeap(
     IN HANDLE HeapHandle,
     IN ULONG Flags,
-    IN ULONG Size
+    IN SIZE_T Size
 );
 
 NTSYSAPI
@@ -522,7 +539,7 @@ RtlExtendHeap(
     IN HANDLE Heap,
     IN ULONG Flags,
     IN PVOID P,
-    IN ULONG Size
+    IN SIZE_T Size
 );
 
 NTSYSAPI
@@ -558,6 +575,14 @@ RtlGetUserInfoHeap(
     OUT PULONG UserFlags
 );
 
+NTSYSAPI
+PVOID
+NTAPI
+RtlProtectHeap(
+    IN PVOID HeapHandle,
+    IN BOOLEAN Protect
+);
+
 NTSYSAPI
 PWSTR
 NTAPI
@@ -576,7 +601,7 @@ RtlReAllocateHeap(
     HANDLE Heap,
     ULONG Flags,
     PVOID Ptr,
-    ULONG Size
+    SIZE_T Size
 );
 
 NTSYSAPI
@@ -611,8 +636,17 @@ RtlSetUserValueHeap(
     IN PVOID UserValue
 );
 
+BOOLEAN
+NTAPI
+RtlSetUserFlagsHeap(
+    IN PVOID HeapHandle,
+    IN ULONG Flags,
+    IN PVOID BaseAddress,
+    IN ULONG UserFlags
+);
+
 NTSYSAPI
-ULONG
+SIZE_T
 NTAPI
 RtlSizeHeap(
     IN PVOID HeapHandle,
@@ -629,6 +663,14 @@ RtlValidateHeap(
     PVOID P
 );
 
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlWalkHeap(
+    IN HANDLE HeapHandle,
+    IN PVOID HeapEntry
+);
+
 #define RtlGetProcessHeap() (NtCurrentPeb()->ProcessHeap)
 
 //
@@ -660,7 +702,7 @@ RtlAddAccessAllowedAceEx(
     IN OUT PACL pAcl,
     IN ULONG dwAceRevision,
     IN ULONG AceFlags,
-    IN ULONG AccessMask,
+    IN ACCESS_MASK AccessMask,
     IN PSID pSid
 );
 
@@ -671,7 +713,7 @@ RtlAddAccessAllowedObjectAce(
     IN OUT PACL pAcl,
     IN ULONG dwAceRevision,
     IN ULONG AceFlags,
-    IN ULONG AccessMask,
+    IN ACCESS_MASK AccessMask,
     IN GUID *ObjectTypeGuid  OPTIONAL,
     IN GUID *InheritedObjectTypeGuid  OPTIONAL,
     IN PSID pSid
@@ -705,7 +747,7 @@ RtlAddAccessDeniedObjectAce(
     IN OUT PACL pAcl,
     IN ULONG dwAceRevision,
     IN ULONG AceFlags,
-    IN ULONG AccessMask,
+    IN ACCESS_MASK AccessMask,
     IN GUID *ObjectTypeGuid  OPTIONAL,
     IN GUID *InheritedObjectTypeGuid  OPTIONAL,
     IN PSID pSid
@@ -899,6 +941,14 @@ RtlCreateSecurityDescriptorRelative(
     IN ULONG Revision
 );
 
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlCopySecurityDescriptor(
+    IN PSECURITY_DESCRIPTOR pSourceSecurityDescriptor,
+    OUT PSECURITY_DESCRIPTOR pDestinationSecurityDescriptor
+);
+
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -1047,6 +1097,8 @@ RtlMapGenericMask(
     PGENERIC_MAPPING GenericMapping
 );
 
+#ifdef NTOS_MODE_USER
+
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -1057,6 +1109,8 @@ RtlQueryInformationAcl(
     ACL_INFORMATION_CLASS InformationClass
 );
 
+#endif
+
 NTSYSAPI
 VOID
 NTAPI
@@ -1126,6 +1180,8 @@ RtlSetGroupSecurityDescriptor(
     IN BOOLEAN GroupDefaulted
 );
 
+#ifdef NTOS_MODE_USER
+
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -1136,6 +1192,8 @@ RtlSetInformationAcl(
     ACL_INFORMATION_CLASS InformationClass
 );
 
+#endif
+
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -1312,6 +1370,8 @@ RtlCharToInteger(
 //
 // Byte Swap Functions
 //
+#ifdef NTOS_MODE_USER
+
 #if (defined(_M_IX86) && (_MSC_FULL_VER > 13009037)) || \
     ((defined(_M_AMD64) || \
      defined(_M_IA64)) && (_MSC_FULL_VER > 13009175))
@@ -1326,8 +1386,15 @@ unsigned __int64 __cdecl _byteswap_uint64(unsigned __int64);
 #define RtlUlongByteSwap(_x) _byteswap_ulong((_x))
 #define RtlUlonglongByteSwap(_x) _byteswap_uint64((_x))
 
+#elif defined (__GNUC__)
+
+#define RtlUshortByteSwap(_x) _byteswap_ushort((USHORT)(_x))
+#define RtlUlongByteSwap(_x) _byteswap_ulong((_x))
+#define RtlUlonglongByteSwap(_x) _byteswap_uint64((_x))
+
 #else
 
+#if (NTDDI_VERSION >= NTDDI_WIN2K)
 NTSYSAPI
 USHORT
 FASTCALL
@@ -1342,8 +1409,10 @@ NTSYSAPI
 ULONGLONG
 FASTCALL
 RtlUlonglongByteSwap(IN ULONGLONG Source);
+#endif
 
 #endif
+#endif // NTOS_MODE_USER
 
 //
 // Unicode->Ansi String Functions
@@ -1409,7 +1478,7 @@ RtlUpcaseUnicodeToOemN(
     PCHAR OemString,
     ULONG OemSize,
     PULONG ResultSize,
-    PWCHAR UnicodeString,
+    PCWCH UnicodeString,
     ULONG UnicodeSize
 );
 
@@ -1439,7 +1508,7 @@ RtlUnicodeToOemN(
     PCHAR OemString,
     ULONG OemSize,
     PULONG ResultSize,
-    PWCHAR UnicodeString,
+    PCWCH UnicodeString,
     ULONG UnicodeSize
 );
 
@@ -1464,7 +1533,7 @@ RtlUpcaseUnicodeToMultiByteN(
     PCHAR MbString,
     ULONG MbSize,
     PULONG ResultSize,
-    PWCHAR UnicodeString,
+    PCWCH UnicodeString,
     ULONG UnicodeSize
 );
 
@@ -1473,7 +1542,7 @@ NTSTATUS
 NTAPI
 RtlUnicodeToMultiByteSize(
     PULONG MbSize,
-    PWCHAR UnicodeString,
+    PCWCH UnicodeString,
     ULONG UnicodeSize
 );
 
@@ -1501,7 +1570,7 @@ RtlOemToUnicodeN(
     PWSTR UnicodeString,
     ULONG MaxBytesInUnicodeString,
     PULONG BytesInUnicodeString,
-    IN PCHAR OemString,
+    IN PCCH OemString,
     ULONG BytesInOemString
 );
 
@@ -1611,8 +1680,6 @@ RtlDowncaseUnicodeString(
     IN BOOLEAN AllocateDestinationString
 );
 
-#endif
-
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -1622,6 +1689,8 @@ RtlDuplicateUnicodeString(
     OUT PUNICODE_STRING DestinationString
 );
 
+#endif
+
 NTSYSAPI
 BOOLEAN
 NTAPI
@@ -1673,12 +1742,12 @@ RtlInitUnicodeStringEx(
 );
 
 NTSYSAPI
-ULONG
+BOOLEAN
 NTAPI
 RtlIsTextUnicode(
     PVOID Buffer,
-    ULONG Length,
-    ULONG *Flags
+    INT Length,
+    INT *Flags
 );
 
 NTSYSAPI
@@ -1741,6 +1810,14 @@ RtlInitAnsiString(
     PCSZ SourceString
 );
 
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlInitAnsiStringEx(
+    PANSI_STRING DestinationString,
+    PCSZ SourceString
+);
+
 //
 // OEM String Functions
 //
@@ -1849,6 +1926,13 @@ RtlFillMemoryUlong(
 //
 // Process Management Functions
 //
+NTSYSAPI
+PPEB
+NTAPI
+RtlGetCurrentPeb(
+    VOID
+);
+
 NTSYSAPI
 VOID
 NTAPI
@@ -1893,9 +1977,9 @@ RtlCreateUserThread(
     IN HANDLE ProcessHandle,
     IN PSECURITY_DESCRIPTOR SecurityDescriptor,
     IN BOOLEAN CreateSuspended,
-    IN LONG StackZeroBits,
-    IN ULONG StackReserve,
-    IN ULONG StackCommit,
+    IN ULONG StackZeroBits,
+    IN SIZE_T StackReserve,
+    IN SIZE_T StackCommit,
     IN PTHREAD_START_ROUTINE StartAddress,
     IN PVOID Parameter,
     IN OUT PHANDLE ThreadHandle,
@@ -1928,6 +2012,11 @@ RtlInitializeContext(
     IN PINITIAL_TEB InitialTeb
 );
 
+NTSYSAPI
+BOOLEAN
+NTAPI
+RtlIsThreadWithinLoaderCallout(VOID);
+
 NTSYSAPI
 PRTL_USER_PROCESS_PARAMETERS
 NTAPI
@@ -1938,6 +2027,19 @@ VOID
 NTAPI
 RtlReleasePebLock(VOID);
 
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlRemoteCall(
+    IN HANDLE Process,
+    IN HANDLE Thread,
+    IN PVOID CallSite,
+    IN ULONG ArgumentCount,
+    IN PULONG Arguments,
+    IN BOOLEAN PassContext,
+    IN BOOLEAN AlreadySuspended
+);
+
 NTSYSAPI
 VOID
 NTAPI
@@ -1947,11 +2049,33 @@ RtlSetProcessIsCritical(
     IN BOOLEAN IsWinlogon
 );
 
+NTSYSAPI
+ULONG
+NTAPI
+RtlGetCurrentProcessorNumber(
+    VOID
+);
+
 #define NtCurrentPeb() (NtCurrentTeb()->ProcessEnvironmentBlock)
 
 //
 // Thread Pool Functions
 //
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlDeregisterWaitEx(
+    IN HANDLE hWaitHandle,
+    IN HANDLE hCompletionEvent
+);
+
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlDeregisterWait(
+    IN HANDLE hWaitHandle
+);
+
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -1961,6 +2085,27 @@ RtlQueueWorkItem(
     IN ULONG Flags
 );
 
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlSetIoCompletionCallback(
+    IN HANDLE FileHandle,
+    IN PIO_APC_ROUTINE Callback,
+    IN ULONG Flags
+);
+
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlRegisterWait(
+    IN PHANDLE phNewWaitObject,
+    IN HANDLE hObject,
+    IN WAITORTIMERCALLBACKFUNC Callback,
+    IN PVOID pvContext,
+    IN ULONG ulMilliseconds,
+    IN ULONG ulFlags
+);
+
 //
 // Environment/Path Functions
 //
@@ -2399,6 +2544,21 @@ RtlSetBits(
     IN ULONG NumberToSet
 );
 
+NTSYSAPI
+VOID
+NTAPI
+RtlSetAllBits(
+    PRTL_BITMAP BitMapHeader
+);
+
+NTSYSAPI
+BOOLEAN
+NTAPI
+RtlTestBit(
+    PRTL_BITMAP BitMapHeader,
+    ULONG BitNumber
+);
+
 //
 // Timer Functions
 //
@@ -2492,6 +2652,7 @@ DbgPrintEx(
     IN ...
 );
 
+NTSYSAPI
 ULONG
 NTAPI
 DbgPrompt(
@@ -2502,12 +2663,38 @@ DbgPrompt(
 
 VOID
 NTAPI
-DbgBreakPoint(VOID);
+DbgBreakPoint(
+    VOID
+);
+
+VOID
+NTAPI
+DbgLoadImageSymbols(
+    IN PSTRING Name,
+    IN PVOID Base,
+    IN ULONG_PTR ProcessId
+);
+
+VOID
+NTAPI
+DbgUnLoadImageSymbols(
+    IN PSTRING Name,
+    IN PVOID Base,
+    IN ULONG_PTR ProcessId
+);
+
+VOID
+NTAPI
+DbgCommandString(
+    IN PCCH Name,
+    IN PCCH Command
+);
 
 //
 // Generic Table Functions
 //
 #if defined(NTOS_MODE_USER) || defined(_NTIFS_)
+NTSYSAPI
 PVOID
 NTAPI
 RtlInsertElementGenericTable(
@@ -2517,6 +2704,7 @@ RtlInsertElementGenericTable(
     OUT PBOOLEAN NewElement OPTIONAL
 );
 
+NTSYSAPI
 PVOID
 NTAPI
 RtlInsertElementGenericTableFull(
@@ -2528,12 +2716,14 @@ RtlInsertElementGenericTableFull(
     IN TABLE_SEARCH_RESULT SearchResult
 );
 
+NTSYSAPI
 BOOLEAN
 NTAPI
 RtlIsGenericTableEmpty(
     IN PRTL_GENERIC_TABLE Table
 );
 
+NTSYSAPI
 PVOID
 NTAPI
 RtlLookupElementGenericTableFull(
@@ -2673,6 +2863,24 @@ LdrRelocateImageWithBias(
 // Activation Context Functions
 //
 #ifdef NTOS_MODE_USER
+
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlActivateActivationContext(
+    IN ULONG Unknown,
+    IN HANDLE Handle,
+    OUT PULONG_PTR Cookie
+);
+
+NTSYSAPI
+VOID
+NTAPI
+RtlAddRefActivationContext(
+    PVOID Context
+);
+
+
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -2688,6 +2896,14 @@ RtlAllocateActivationContextStack(
     IN PVOID *Context
 );
 
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlCreateActivationContext(
+    OUT PHANDLE Handle,
+    IN OUT PVOID ReturnedData
+);
+
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -2699,9 +2915,22 @@ NTSYSAPI
 VOID
 NTAPI
 RtlReleaseActivationContext(
-    IN PVOID *Context
+    IN HANDLE handle
 );
 
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlDeactivateActivationContext(
+    ULONG dwFlags,
+    ULONG_PTR ulCookie
+);
+
+NTSYSAPI
+VOID
+NTAPI
+RtlFreeThreadActivationContextStack(void);
+
 NTSYSAPI
 NTSTATUS
 NTAPI
@@ -2728,12 +2957,34 @@ NTSYSAPI
 NTSTATUS
 NTAPI
 RtlFindActivationContextSectionString(
-    IN PVOID Unknown0,
-    IN PVOID Unknown1,
+    IN ULONG dwFlags,
+    IN const GUID *ExtensionGuid,
     IN ULONG SectionType,
     IN PUNICODE_STRING SectionName,
-    IN PVOID Unknown2
+    IN OUT PVOID ReturnedData
+);
+
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlQueryInformationActivationContext(
+    DWORD dwFlags,
+    PVOID Context,
+    PVOID pvSubInstance,
+    ULONG ulInfoClass,
+    PVOID pvBuffer,
+    SIZE_T cbBuffer OPTIONAL,
+    SIZE_T *pcbWrittenOrRequired OPTIONAL
+);
+
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlZombifyActivationContext(
+    PVOID Context
 );
+
+
 #endif
 
 //
@@ -2750,7 +3001,17 @@ RtlCheckRegistryKey(
 NTSYSAPI
 NTSTATUS
 NTAPI
-RtlFormatCurrentUserKeyPath(IN OUT PUNICODE_STRING KeyPath);
+RtlCreateRegistryKey(
+    IN ULONG RelativeTo,
+    IN PWSTR Path
+);
+
+NTSYSAPI
+NTSTATUS
+NTAPI
+RtlFormatCurrentUserKeyPath(
+    IN OUT PUNICODE_STRING KeyPath
+);
 
 NTSYSAPI
 NTSTATUS
@@ -2796,6 +3057,14 @@ RtlWriteRegistryValue(
 //
 // NLS Functions
 //
+NTSYSAPI
+VOID
+NTAPI
+RtlGetDefaultCodePage(
+    OUT PUSHORT AnsiCodePage,
+    OUT PUSHORT OemCodePage
+);
+
 NTSYSAPI
 VOID
 NTAPI
@@ -2892,6 +3161,13 @@ RtlUniform(
     IN PULONG Seed
 );
 
+NTSYSAPI
+ULONG
+NTAPI
+RtlRandom(
+    IN OUT PULONG Seed
+);
+
 NTSYSAPI
 ULONG
 NTAPI
@@ -2982,6 +3258,14 @@ RtlTimeFieldsToTime(
     PLARGE_INTEGER Time
 );
 
+NTSYSAPI
+BOOLEAN
+NTAPI
+RtlTimeToSecondsSince1970(
+    PLARGE_INTEGER Time,
+    OUT PULONG SecondsSince1970
+);
+
 NTSYSAPI
 VOID
 NTAPI