string.c File Reference

#include "string.h"
#include "nt.h"
#include "ntrtlp.h"

Go to the source code of this file.

Functions
VOID	RtlInitString (OUT PSTRING DestinationString, IN PCSZ SourceString OPTIONAL)
VOID	RtlInitAnsiString (OUT PANSI_STRING DestinationString, IN PCSZ SourceString OPTIONAL)
VOID	RtlInitUnicodeString (OUT PUNICODE_STRING DestinationString, IN PCWSTR SourceString OPTIONAL)
VOID	RtlCopyString (OUT PSTRING DestinationString, IN PSTRING SourceString OPTIONAL)
CHAR	RtlUpperChar (register IN CHAR Character)
LONG	RtlCompareString (IN PSTRING String1, IN PSTRING String2, IN BOOLEAN CaseInSensitive)
BOOLEAN	RtlEqualString (IN PSTRING String1, IN PSTRING String2, IN BOOLEAN CaseInSensitive)
BOOLEAN	RtlPrefixString (IN PSTRING String1, IN PSTRING String2, IN BOOLEAN CaseInSensitive)
BOOLEAN	RtlCreateUnicodeStringFromAsciiz (OUT PUNICODE_STRING DestinationString, IN PCSZ SourceString)
VOID	RtlUpperString (IN PSTRING DestinationString, IN PSTRING SourceString)
NTSTATUS	RtlAppendAsciizToString (IN PSTRING Destination, IN PCSZ Source OPTIONAL)
NTSTATUS	RtlAppendStringToString (IN PSTRING Destination, IN PSTRING Source)
SIZE_T NTAPI	RtlCompareMemoryUlong (PVOID Source, SIZE_T Length, ULONG Pattern)
Variables
PUSHORT	NlsAnsiToUnicodeData
PCH	NlsUnicodeToAnsiData
PUSHORT	NlsLeadByteInfo
PUSHORT	NlsUnicodeToMbAnsiData
BOOLEAN	NlsMbCodePageTag

---

Function Documentation

NTSTATUS RtlAppendAsciizToString (  IN PSTRING  Destination, IN PCSZ Source  OPTIONAL )

Definition at line 613 of file string.c. References n, strlen(), and USHORT. : This routine appends the supplied ASCIIZ string to an existing PSTRING. It will copy bytes from the Source PSZ to the destination PSTRING up to the destinations PSTRING->MaximumLength field. Arguments: IN PSTRING Destination, - Supplies a pointer to the destination string IN PSZ Source - Supplies the string to append to the destination Return Value: STATUS_SUCCESS - The source string was successfully appended to the destination counted string. STATUS_BUFFER_TOO_SMALL - The destination string length was not big enough to allow the source string to be appended. The Destination string length is not updated. --*/ { USHORT n; if (ARGUMENT_PRESENT( Source )) { n = (USHORT)strlen( Source ); if ((n + Destination->Length) > Destination->MaximumLength) { return( STATUS_BUFFER_TOO_SMALL ); } RtlMoveMemory( &Destination->Buffer[ Destination->Length ], Source, n ); Destination->Length += n; } return( STATUS_SUCCESS ); }

NTSTATUS RtlAppendStringToString (  IN PSTRING  Destination, IN PSTRING  Source )

Definition at line 663 of file string.c. References n, and USHORT. Referenced by CmpInitializeHiveList(), CmpOpenHiveFiles(), Delete(), Dump(), IopGetRootDevices(), IopInitializeDeviceInstanceKey(), IopInitializeDeviceKey(), main(), and MiResolveImageReferences(). : This routine will concatinate two PSTRINGs together. It will copy bytes from the source up to the MaximumLength of the destination. Arguments: IN PSTRING Destination, - Supplies the destination string IN PSTRING Source - Supplies the source for the string copy Return Value: STATUS_SUCCESS - The source string was successfully appended to the destination counted string. STATUS_BUFFER_TOO_SMALL - The destination string length was not big enough to allow the source string to be appended. The Destination string length is not updated. --*/ { USHORT n = Source->Length; if (n) { if ((n + Destination->Length) > Destination->MaximumLength) { return( STATUS_BUFFER_TOO_SMALL ); } RtlMoveMemory( &Destination->Buffer[ Destination->Length ], Source->Buffer, n ); Destination->Length += n; } return( STATUS_SUCCESS ); }

SIZE_T NTAPI RtlCompareMemoryUlong (  PVOID  Source, SIZE_T  Length, ULONG  Pattern )

Definition at line 714 of file string.c. References Pattern. Referenced by IopTrackLink(), MiInitMachineDependent(), and RtlpValidateHeapSegment(). : This function compares two blocks of memory and returns the number of bytes that compared equal. N.B. This routine requires that the source address is aligned on a longword boundary and that the length is an even multiple of longwords. Arguments: Source - Supplies a pointer to the block of memory to compare against. Length - Supplies the Length, in bytes, of the memory to be compared. Pattern - Supplies a 32-bit pattern to compare against the block of memory. Return Value: The number of bytes that compared equal is returned as the function value. If all bytes compared equal, then the length of the orginal block of memory is returned. Returns zero if either the Source address is not longword aligned or the length is not a multiple of longwords. --*/ { SIZE_T CountLongs; PULONG p = (PULONG)Source; PCHAR p1, p2; if (((ULONG_PTR)p & (sizeof( ULONG )-1)) || (Length & (sizeof( ULONG )-1)) ) { return( 0 ); } CountLongs = Length / sizeof( ULONG ); while (CountLongs--) { if (*p++ != Pattern) { p1 = (PCHAR)(p - 1); p2 = (PCHAR)&Pattern; Length = p1 - (PCHAR)Source; while (*p1++ == *p2++) { if (p1 > (PCHAR)p) { break; } Length++; } } } return( Length ); }

LONG RtlCompareString (  IN PSTRING  String1, IN PSTRING  String2, IN BOOLEAN  CaseInSensitive )

Definition at line 322 of file string.c. References RtlUpperChar(), String1, and String2. Referenced by StringCompare(). 00330 : 00331 00332 The RtlCompareString function compares two counted strings. The return 00333 value indicates if the strings are equal or String1 is less than String2 00334 or String1 is greater than String2. 00335 00336 The CaseInSensitive parameter specifies if case is to be ignored when 00337 doing the comparison. 00338 00339 Arguments: 00340 00341 String1 - Pointer to the first string. 00342 00343 String2 - Pointer to the second string. 00344 00345 CaseInsensitive - TRUE if case should be ignored when doing the 00346 comparison. 00347 00348 Return Value: 00349 00350 Signed value that gives the results of the comparison: 00351 00352 Zero - String1 equals String2 00353 00354 < Zero - String1 less than String2 00355 00356 > Zero - String1 greater than String2 00357 00358 00359 --*/ 00360 00361 { 00362 00363 PUCHAR s1, s2, Limit; 00364 LONG n1, n2; 00365 UCHAR c1, c2; 00366 00367 s1 = String1->Buffer; 00368 s2 = String2->Buffer; 00369 n1 = String1->Length; 00370 n2 = String2->Length; 00371 Limit = s1 + (n1 <= n2 ? n1 : n2); 00372 if (CaseInSensitive) { 00373 while (s1 < Limit) { 00374 c1 = *s1++; 00375 c2 = *s2++; 00376 if (c1 !=c2) { 00377 c1 = RtlUpperChar(c1); 00378 c2 = RtlUpperChar(c2); 00379 if (c1 != c2) { 00380 return (LONG)c1 - (LONG)c2; 00381 } 00382 } 00383 } 00384 00385 } else { 00386 while (s1 < Limit) { 00387 c1 = *s1++; 00388 c2 = *s2++; 00389 if (c1 != c2) { 00390 return (LONG)c1 - (LONG)c2; 00391 } 00392 } 00393 } 00394 00395 return n1 - n2; 00396 }

VOID RtlCopyString (  OUT PSTRING  DestinationString, IN PSTRING SourceString  OPTIONAL )

Definition at line 196 of file string.c. References n, SourceString, and USHORT. Referenced by IopReassignSystemRoot(), main(), and TestString(). 00203 : 00204 00205 The RtlCopyString function copies the SourceString to the 00206 DestinationString. If SourceString is not specified, then 00207 the Length field of DestinationString is set to zero. The 00208 MaximumLength and Buffer fields of DestinationString are not 00209 modified by this function. 00210 00211 The number of bytes copied from the SourceString is either the 00212 Length of SourceString or the MaximumLength of DestinationString, 00213 whichever is smaller. 00214 00215 Arguments: 00216 00217 DestinationString - Pointer to the destination string. 00218 00219 SourceString - Optional pointer to the source string. 00220 00221 Return Value: 00222 00223 None. 00224 00225 --*/ 00226 00227 { 00228 PSZ src, dst; 00229 ULONG n; 00230 00231 if (ARGUMENT_PRESENT( SourceString )) { 00232 dst = DestinationString->Buffer; 00233 src = SourceString->Buffer; 00234 n = SourceString->Length; 00235 if ((USHORT)n > DestinationString->MaximumLength) { 00236 n = DestinationString->MaximumLength; 00237 } 00238 DestinationString->Length = (USHORT)n; 00239 while (n) { 00240 *dst++ = *src++; 00241 n--; 00242 } 00243 } 00244 else { 00245 DestinationString->Length = 0; 00246 } 00247 }

BOOLEAN RtlCreateUnicodeStringFromAsciiz (  OUT PUNICODE_STRING  DestinationString, IN PCSZ  SourceString )

Definition at line 544 of file string.c. References FALSE, NT_SUCCESS, NTSTATUS(), RtlAnsiStringToUnicodeString(), RtlInitAnsiString(), SourceString, Status, and TRUE. Referenced by CreateWindowStationA(), IopInitializeBootLogging(), OpenDesktopA(), and OpenWindowStationA(). { ANSI_STRING AnsiString; NTSTATUS Status; RtlInitAnsiString( &AnsiString, SourceString ); Status = RtlAnsiStringToUnicodeString( DestinationString, &AnsiString, TRUE ); if (NT_SUCCESS( Status )) { return( TRUE ); } else { return( FALSE ); } }

BOOLEAN RtlEqualString (  IN PSTRING  String1, IN PSTRING  String2, IN BOOLEAN  CaseInSensitive )

Definition at line 399 of file string.c. References FALSE, RtlUpperChar(), String1, String2, and TRUE. Referenced by CmpMatchAcpiOemIdRule(), DumpObjectDirs(), IoGetBootDiskInformation(), IopCreateArcNames(), IopInitializeBuiltinDriver(), IopLoadDriver(), RtlEqualDomainName(), and StringEqual(). 00407 : 00408 00409 The RtlEqualString function compares two counted strings for equality. 00410 00411 The CaseInSensitive parameter specifies if case is to be ignored when 00412 doing the comparison. 00413 00414 Arguments: 00415 00416 String1 - Pointer to the first string. 00417 00418 String2 - Pointer to the second string. 00419 00420 CaseInsensitive - TRUE if case should be ignored when doing the 00421 comparison. 00422 00423 Return Value: 00424 00425 Boolean value that is TRUE if String1 equals String2 and FALSE otherwise. 00426 00427 --*/ 00428 00429 { 00430 00431 PUCHAR s1, s2, Limit; 00432 LONG n1, n2; 00433 UCHAR c1, c2; 00434 00435 n1 = String1->Length; 00436 n2 = String2->Length; 00437 if (n1 == n2) { 00438 s1 = String1->Buffer; 00439 s2 = String2->Buffer; 00440 Limit = s1 + n1; 00441 if (CaseInSensitive) { 00442 while (s1 < Limit) { 00443 c1 = *s1++; 00444 c2 = *s2++; 00445 if (c1 != c2) { 00446 c1 = RtlUpperChar(c1); 00447 c2 = RtlUpperChar(c2); 00448 if (c1 != c2) { 00449 return FALSE; 00450 } 00451 } 00452 } 00453 00454 return TRUE; 00455 00456 } else { 00457 while (s1 < Limit) { 00458 c1 = *s1++; 00459 c2 = *s2++; 00460 if (c1 != c2) { 00461 return FALSE; 00462 } 00463 } 00464 00465 return TRUE; 00466 } 00467 00468 } else { 00469 return FALSE; 00470 } 00471 }

VOID RtlInitAnsiString (  OUT PANSI_STRING  DestinationString, IN PCSZ SourceString  OPTIONAL )

Definition at line 102 of file string.c. References SourceString, strlen(), and USHORT. Referenced by ChangeDisplaySettingsEx(), CmpAddAliasEntry(), CmpAppendStringToMultiSz(), CmpCreateControlSet(), CmpCreateHwProfileFriendlyName(), CmpGetAddRegInfData(), CmpInitializeMachineDependentConfiguration(), CmpInitializeRegistryNode(), CmpInitializeSystemHive(), CmpOpenRegKey(), CmpProcessAddRegLine(), CmpProcessBitRegLine(), CmpProcessDelRegLine(), CmpSetVersionData(), CreateDesktopA(), CsrClientConnectToServer(), EnumDisplayDevices(), EnumDisplaySettingsEx(), ExpSystemErrorHandler(), GetHardErrorText(), GetTaskName(), IoGetBootDiskInformation(), IopAddRemoteBootValuesToRegistry(), IopApplySystemPartitionProt(), IopAssignNetworkDriveLetter(), IopCopyBootLogRegistryToFile(), IopCreateArcNames(), IopGetDumpStack(), IopMarkBootPartition(), IopReassignSystemRoot(), IopSetupRemoteBootCard(), IopWriteIpAddressToRegistry(), LdrpInitializeProcess(), LdrpLoadImportModule(), LdrpSnapThunk(), LdrpUpdateLoadCount(), main(), MemPrintWriteThread(), MiLoadSystemImage(), MiResolveImageReferences(), processargs(), RtlCreateUnicodeStringFromAsciiz(), SetConsoleInputExeNameA(), and xHalIoAssignDriveLetters(). : The RtlInitAnsiString function initializes an NT counted string. The DestinationString is initialized to point to the SourceString and the Length and MaximumLength fields of DestinationString are initialized to the length of the SourceString, which is zero if SourceString is not specified. Arguments: DestinationString - Pointer to the counted string to initialize SourceString - Optional pointer to a null terminated string that the counted string is to point to. Return Value: None. --*/ { ULONG Length; DestinationString->Buffer = (PCHAR)SourceString; if (ARGUMENT_PRESENT( SourceString )) { Length = strlen(SourceString); DestinationString->Length = (USHORT)Length; DestinationString->MaximumLength = (USHORT)(Length+1); } else { DestinationString->Length = 0; DestinationString->MaximumLength = 0; } }

VOID RtlInitString (  OUT PSTRING  DestinationString, IN PCSZ SourceString  OPTIONAL )

Definition at line 56 of file string.c. References SourceString, strlen(), and USHORT. Referenced by CmpMatchAcpiOemIdRule(), CsrClientConnectToServer(), CtLnpQos(), CtLpcQos(), DoTest(), DumpObjectDirs(), FtCreateKey(), FtDeleteValue(), FtOpenKey(), FtReturnValue(), FtSetValue(), IopSetupRemoteBootCard(), main(), MiLoadSystemImage(), NtQuerySystemEnvironmentValue(), obtest(), SepClientOpenPipe(), SepInitializationPhase1(), SepServerSpawnClientProcess(), SepSidTranslation(), SeRmInitPhase1(), SetEnvironment(), SidTranslation(), TestChild(), TestParent(), TestSeInitialize(), TestString(), and xHalIoAssignDriveLetters(). : The RtlInitString function initializes an NT counted string. The DestinationString is initialized to point to the SourceString and the Length and MaximumLength fields of DestinationString are initialized to the length of the SourceString, which is zero if SourceString is not specified. Arguments: DestinationString - Pointer to the counted string to initialize SourceString - Optional pointer to a null terminated string that the counted string is to point to. Return Value: None. --*/ { ULONG Length; DestinationString->Buffer = (PCHAR)SourceString; if (ARGUMENT_PRESENT( SourceString )) { Length = strlen(SourceString); DestinationString->Length = (USHORT)Length; DestinationString->MaximumLength = (USHORT)(Length+1); } else { DestinationString->Length = 0; DestinationString->MaximumLength = 0; } }

VOID RtlInitUnicodeString (  OUT PUNICODE_STRING  DestinationString, IN PCWSTR SourceString  OPTIONAL )

Definition at line 148 of file string.c. References SourceString, and USHORT. Referenced by _UserTestForWinStaAccess(), AllocateUnicodeString(), ArbpGetRegistryValue(), bCheckAndDeleteTTF(), bCleanConvertedTTFs(), bLoadableFontDrivers(), ChangeDisplaySettingsEx(), CheckDesktopPolicy(), CheckRestricted(), CheckValidLayoutName(), CleanupSessionObjectDirectories(), CliGetImeHotKeysFromRegistry(), CliGetPreloadKeyboardLayouts(), CliReadRegistryValue(), CmDeleteKeyRecursive(), CmGetSystemControlValues(), CmGetSystemDriverList(), CmInitSystem1(), CmpAddAcpiAliasEntry(), CmpAddAliasEntry(), CmpAddDockingInfo(), CmpAddDriverToList(), CmpAddToHiveFileList(), CmpCloneControlSet(), CmpCloneHwProfile(), CmpCreateControlSet(), CmpCreateHwProfileFriendlyName(), CmpCreateObjectTypes(), CmpCreatePerfKeys(), CmpCreatePredefined(), CmpCreateRootNode(), CmpFindControlSet(), CmpFindDrivers(), CmpFindNLSData(), CmpFindProfileOption(), CmpFindRSDTTable(), CmpGetAcpiProfileInformation(), CmpGetRegistryValue(), CmpInitializeHiveList(), CmpInitializeMachineDependentConfiguration(), CmpInitializeRegistryNames(), CmpInitializeRegistryNode(), CmpInterlockedFunction(), CmpIsLoadType(), CmpLinkKeyToHive(), CmpMapPhysicalAddress(), CmpMoveBiosAliasTable(), CmpOpenHiveFiles(), CmpRemoveFromHiveFileList(), CmpSaveBootControlSet(), CmpSetCurrentProfile(), CmpSetVersionData(), CmpSortDriverList(), CmpWalkPath(), CmSetAcpiHwProfile(), CommonCreateWindowStation(), CommonOpenWindowStation(), ComPortDBAdd(), ConnectToTerminalServer(), ConsoleClientConnectRoutine(), CreateDesktopW(), CreateWindowStationW(), CtLpcQos(), DbgkCreateThread(), DbgSspConnectToDbg(), DbgUiConnectToDbg(), DoEventTest(), DoMutantTest(), DoSemaphoreTest(), DoTimerTest(), DrGetDeviceName(), DriverEntry(), EhOpenHive(), EisaBuildEisaDeviceNode(), EisaGetEisaDevicesResources(), EnumDisplayDevices(), EnumDisplaySettingsEx(), ExpEventInitialization(), ExpEventPairInitialization(), ExpGetCurrentUserUILanguage(), ExpGetUILanguagePolicy(), ExpInitializeCallbacks(), ExpMutantInitialization(), ExpProfileInitialization(), ExpQueryLegacyDriverInformation(), ExpSemaphoreInitialization(), ExpSetCurrentUserUILanguage(), ExpSystemErrorHandler(), ExpTimerInitialization(), ExpUuidLoadSequenceNumber(), ExpUuidSaveSequenceNumber(), ExpValidateLocale(), ExpWin32Initialization(), FastGetProfileDwordW(), FastGetProfileIntW(), FastGetProfileStringW(), FastGetProfileValue(), FastWriteProfileStringW(), FastWriteProfileValue(), FsRecCreateAndRegisterDO(), FsRecLoadFileSystem(), FsRtlpOpenDev(), FsRtlpSetSymbolicLink(), FsRtlRegisterUncProvider(), FsVgaServiceParameters(), GetActiveKeyboardName(), GetBadAppCmdLine(), GetConsoleInputExeNameA(), GetDeviceChangeInfo(), GetErrorMode(), GetHardErrorText(), GetRealDllFileNameWorker(), GetRegIntFromID(), GetServerIMEKeyboardLayout(), HalpEnableAutomaticDriveLetterAssignment(), HalpNextDriveLetter(), HalpNextMountLetter(), HalpSetMountLetter(), InitCreateObjectDirectory(), InitCreateUserSubsystem(), InitializeFullScreen(), InitializeRestrictedStuff(), InitiateWin32kCleanup(), InternalRegisterClassEx(), IoCreateDevice(), IoepGetErrCaseDB(), IoepGetErrMessage(), IoepHandleErrCase(), IoepLogErr(), IoErrInitSystem(), IoGetDeviceProperty(), IoGetLegacyVetoList(), IoInitSystem(), IoIsValidNameGraftingBuffer(), IopAddRemoteBootValuesToRegistry(), IopAppendStringToValueKey(), IopAssignNetworkDriveLetter(), IopBootLog(), IopBootLogToFile(), IopBuildCmResourceList(), IopCacheNetbiosNameForIpAddress(), IopCallDriverAddDevice(), IopCallDriverAddDeviceQueryRoutine(), IopChangeDeviceObjectFromRegistryProperties(), IopCheckDependencies(), IopConnectLinkTrackingPort(), IopCopyBootLogRegistryToFile(), IopCreateArcNames(), IopCreateMadeupNode(), IopCreateObjectTypes(), IopCreateRootDirectories(), IopDeleteKeyRecursive(), IopDeleteSessionSymLinks(), IopDriverCorrectnessProcessParams(), IopDriverLoadingFailed(), IopErrorLogConnectPort(), IopExecuteHardwareProfileChange(), IopGetLegacyVetoListDrivers(), IopGetRegistryValue(), IopInitializeBootDrivers(), IopInitializeDeviceInstanceKey(), IopInitializePlugPlayServices(), IopInitializeResourceMap(), IopIsFirmwareDisabled(), IopIsReportedAlready(), IopLoadDriver(), IopLoadDumpDriver(), IopMakeGloballyUniqueId(), IopOpenDeviceParametersSubkey(), IopProcessCriticalDevice(), IopProcessNewDeviceNode(), IopProcessSetInterfaceState(), IopProtectSystemPartition(), IopRaiseHardError(), IopReadDumpRegistry(), IopRemoveDeviceInterfaces(), IopRemoveStringFromValueKey(), IopRestartDeviceNode(), IopSafebootDriverLoad(), IopSetDefaultGateway(), IopSetLegacyDeviceInstance(), IopSetSecurityObjectFromRegistry(), IopSetupRemoteBootCard(), IopStartNetworkForRemoteBoot(), IopStartTcpIpForRemoteBoot(), IopUnloadAttachedDriver(), IopUpdateHardwareProfile(), IopWriteAllocatedResourcesToRegistry(), IopWriteIpAddressToRegistry(), IoRegisterPlugPlayNotification(), IoReportDetectedDevice(), IoReportHalResourceUsage(), IsPrivileged(), KbdLayerRealDllFileForWBT(), KeI386VdmInitialize(), KeSetup80387OrEmulate(), LB_CreateLBLine(), LdrGetDllHandle(), LdrLoadAlternateResourceModule(), LdrpCheckForKnownDll(), LdrpDphDetectSnapRoutines(), LdrpDphInitializeTargetDll(), LdrpInitializeProcess(), LdrpLoadDll(), LdrpMapDll(), LdrQueryApplicationCompatibilityGoo(), LdrQueryImageFileExecutionOptions(), LoadAppDlls(), LpcInitSystem(), LpcpCreatePort(), main(), MapperConstructRootEnumTree(), MapperMarkKey(), MapperPhantomizeDetectedComPorts(), MapperSeedKey(), MenuLoadChicagoTemplates(), MenuLoadWinTemplates(), MiBuildImportsForBootDrivers(), MiInitializeDriverVerifierList(), MiLoadSystemImage(), MiSectionInitialization(), MiSessionWideInsertImageAddress(), MiSuperSectionInitialization(), MmGetSystemRoutineAddress(), MyRegOpenKey(), MyRegQueryValue(), NlsKbdInitializePerSystem(), NotificationThread(), NtCreateSymbolicLinkObject(), NtQueryDirectoryObject(), NtQueryOpenSubKeys(), NtSetDefaultLocale(), NtUserCreateWindowStation(), NtUserOpenWindowStation(), NtUserThunkedMenuItemInfo(), ObGetObjectInformation(), ObInitSystem(), ObpCreateDosDevicesDirectory(), ObpProcessDosDeviceSymbolicLink(), OpenDesktopW(), OpenDeviceReparseIndex(), OpenKeyboardLayoutFile(), OpenMultiplePortDevice(), OpenWindowStationW(), ParseReserved(), PnPBiosCopyDeviceParamKey(), PnPBiosCopyIoDecode(), PnPBiosEliminateDupes(), PnPBiosGetBiosInfo(), PnPBiosWriteInfo(), PnPCheckFixedIoOverrideDecodes(), PnPGetDevnodeExcludeList(), processargs(), PsLocateSystemDll(), PspInitPhase0(), RawInputThread(), RegInitialize(), RegReadApcProcedure(), RegReadBinaryFile(), RemoteMessageThread(), RtlAddActionToRXact(), RtlAppendUnicodeToString(), RtlApplyRXact(), RtlConvertUiListToApiList(), RtlCreateUserProcess(), RtlDeleteRegistryValue(), RtlDosPathNameToNtPathName_U(), RtlDosSearchPath_U(), RtlGetFullPathName_U(), RtlGetFullPathName_Ustr(), RtlGetNtProductType(), RtlInitializeRXact(), RtlInitUnicodeStringOrId(), RtlIsDosDeviceName_U(), RtlIsDosDeviceName_Ustr(), RtlOpenCurrentUser(), RtlpCheckRelativeDrive(), RtlpDebugPageHeapCreate(), RtlpResetDriveEnvironment(), RtlpValidateCurrentDirectory(), RtlQueryRegistryValues(), RtlVolumeDeviceToDosName(), RtlWriteRegistryValue(), SepAdtInitializeAuditingOptions(), SepAdtInitializeBounds(), SepAdtInitializeCrashOnFail(), SepAdtInitializePhase1(), SepAdtInitializePrivilegeAuditing(), SepAuditFailed(), SepRmCommandServerThreadInit(), SepTokenInitialization(), ServiceMessageBox(), SetAppCompatFlags(), SetAppImeCompatFlags(), SetConsolePalette(), SmbTraceStart(), SrvAllocConsole(), StartRegReadRead(), SubstituteDeviceName(), TerminalServerRequestThread(), UserBeep(), UserClientDllInitialize(), vCleanConvertedTTFs(), VdmpInitialize(), vProcessFontEntry(), vSweepFonts(), xHalIoAssignDriveLetters(), xxxAddFontResourceW(), xxxConnectService(), xxxCreateDisconnectDesktop(), xxxCreateWindowStation(), xxxDesktopThread(), xxxLoadDesktopWallpaper(), xxxLoadHmodIndex(), xxxLoadKeyboardLayoutEx(), xxxMNFindChar(), xxxPSMTextOut(), xxxRegisterForDeviceClassNotifications(), xxxRemoteReconnect(), xxxResolveDesktop(), xxxResolveDesktopForWOW(), xxxSetClassData(), xxxUpdateSystemCursorsFromRegistry(), and xxxUpdateSystemIconsFromRegistry(). : The RtlInitUnicodeString function initializes an NT counted unicode string. The DestinationString is initialized to point to the SourceString and the Length and MaximumLength fields of DestinationString are initialized to the length of the SourceString, which is zero if SourceString is not specified. Arguments: DestinationString - Pointer to the counted string to initialize SourceString - Optional pointer to a null terminated unicode string that the counted string is to point to. Return Value: None. --*/ { ULONG Length; DestinationString->Buffer = (PWSTR)SourceString; if (ARGUMENT_PRESENT( SourceString )) { Length = wcslen( SourceString ) * sizeof( WCHAR ); DestinationString->Length = (USHORT)Length; DestinationString->MaximumLength = (USHORT)(Length + sizeof(UNICODE_NULL)); } else { DestinationString->MaximumLength = 0; DestinationString->Length = 0; } }

BOOLEAN RtlPrefixString (  IN PSTRING  String1, IN PSTRING  String2, IN BOOLEAN  CaseInSensitive )

Definition at line 474 of file string.c. References FALSE, n, RtlUpperChar(), String1, String2, TRUE, and USHORT. Referenced by MiSnapThunk(). : The RtlPrefixString function determines if the String1 counted string parameter is a prefix of the String2 counted string parameter. The CaseInSensitive parameter specifies if case is to be ignored when doing the comparison. Arguments: String1 - Pointer to the first string. String2 - Pointer to the second string. CaseInsensitive - TRUE if case should be ignored when doing the comparison. Return Value: Boolean value that is TRUE if String1 equals a prefix of String2 and FALSE otherwise. --*/ { PSZ s1, s2; USHORT n; UCHAR c1, c2; s1 = String1->Buffer; s2 = String2->Buffer; n = String1->Length; if (String2->Length < n) { return( FALSE ); } if (CaseInSensitive) { while (n) { c1 = *s1++; c2 = *s2++; if (c1 != c2 && RtlUpperChar(c1) != RtlUpperChar(c2)) { return( FALSE ); } n--; } } else { while (n) { if (*s1++ != *s2++) { return( FALSE ); } n--; } } return TRUE; }

CHAR RtlUpperChar (  register IN CHAR  Character  )

Definition at line 250 of file string.c. References HIBYTE, LOBYTE, NLS_UPCASE, NlsAnsiToUnicodeData, NlsLeadByteInfo, NlsMbCodePageTag, NlsUnicodeToAnsiData, NlsUnicodeToMbAnsiData, and USHORT. Referenced by RtlCompareString(), RtlEqualString(), RtlPrefixString(), and RtlUpperString(). 00256 : 00257 00258 This routine returns a character uppercased 00259 . 00260 Arguments: 00261 00262 IN CHAR Character - Supplies the character to upper case 00263 00264 Return Value: 00265 00266 CHAR - Uppercased version of the charac 00267 ter 00268 --*/ 00269 00270 { 00271 // 00272 // NOTE: This assumes an ANSI string and it does NOT upper case 00273 // DOUBLE BYTE characters properly. 00274 // 00275 00276 // 00277 // Handle a - z separately. 00278 // 00279 if (Character <= 'z') { 00280 if (Character >= 'a') { 00281 return Character ^ 0x20; 00282 } 00283 else { 00284 return Character; 00285 } 00286 } 00287 else { 00288 WCHAR wCh; 00289 00290 /* 00291 * Handle extended characters. 00292 */ 00293 if (!NlsMbCodePageTag) { 00294 // 00295 // Single byte code page. 00296 // 00297 wCh = NlsAnsiToUnicodeData[(UCHAR)Character]; 00298 wCh = NLS_UPCASE(wCh); 00299 return NlsUnicodeToAnsiData[(USHORT)wCh]; 00300 } 00301 else { 00302 // 00303 // Multi byte code page. Do nothing to the character 00304 // if it's a lead byte or if the translation of the 00305 // upper case Unicode character is a DBCS character. 00306 // 00307 if (!NlsLeadByteInfo[Character]) { 00308 wCh = NlsAnsiToUnicodeData[(UCHAR)Character]; 00309 wCh = NLS_UPCASE(wCh); 00310 wCh = NlsUnicodeToMbAnsiData[(USHORT)wCh]; 00311 if (!HIBYTE(wCh)) { 00312 return LOBYTE(wCh); 00313 } 00314 } 00315 } 00316 } 00317 00318 return Character; 00319 }

VOID RtlUpperString (  IN PSTRING  DestinationString, IN PSTRING  SourceString )

Definition at line 564 of file string.c. References n, RtlUpperChar(), SourceString, and USHORT. : The RtlUpperString function copies the SourceString to the DestinationString, converting it to upper case. The MaximumLength and Buffer fields of DestinationString are not modified by this function. The number of bytes copied from the SourceString is either the Length of SourceString or the MaximumLength of DestinationString, whichever is smaller. Arguments: DestinationString - Pointer to the destination string. SourceString - Pointer to the source string. Return Value: None. --*/ { PSZ src, dst; ULONG n; dst = DestinationString->Buffer; src = SourceString->Buffer; n = SourceString->Length; if ((USHORT)n > DestinationString->MaximumLength) { n = DestinationString->MaximumLength; } DestinationString->Length = (USHORT)n; while (n) { *dst++ = RtlUpperChar(*src++); n--; } }

---

Variable Documentation

PUSHORT NlsAnsiToUnicodeData

Definition at line 45 of file string.c.

PUSHORT NlsLeadByteInfo

Definition at line 47 of file string.c.

BOOLEAN NlsMbCodePageTag

Definition at line 49 of file string.c. Referenced by CompareNamesCaseSensitive(), ComputeNameLength(), ExpSystemErrorHandler(), IsDBCSEnabledSystem(), RtlConsoleMultiByteToUnicodeN(), RtlIsTextUnicode(), RtlMultiByteToUnicodeN(), RtlMultiByteToUnicodeSize(), RtlResetRtlTranslations(), RtlUnicodeToMultiByteN(), RtlUnicodeToMultiByteSize(), RtlUpcaseUnicodeToMultiByteN(), and RtlUpperChar().

PCH NlsUnicodeToAnsiData

Definition at line 46 of file string.c. Referenced by RtlResetRtlTranslations(), RtlUnicodeToMultiByteN(), RtlUpcaseUnicodeToMultiByteN(), and RtlUpperChar().

PUSHORT NlsUnicodeToMbAnsiData

Definition at line 48 of file string.c. Referenced by RtlResetRtlTranslations(), RtlUnicodeToMultiByteN(), RtlUnicodeToMultiByteSize(), RtlUpcaseUnicodeToMultiByteN(), and RtlUpperChar().

---