KernelBasePathCchAddBackslash Method

Adds a backslash to the end of a string to create the correct syntax for a path. If the source path already has a trailing backslash, no backslash will be added.

This function differs from PathCchAddBackslash(StringBuilder, UInt32) in that you are restricted to a final path of length MAX_PATH.

This function differs from PathAddBackslash(StringBuilder) in that it accepts paths with "\", "\?" and "\?\UNC" prefixes.

Note: This function, or PathCchAddBackslashEx(StringBuilder, UInt32, IntPtr, UInt32), should be used in place of PathAddBackslash(StringBuilder) to prevent the possibility of a buffer overrun.

Definition

Namespace: DevCase.Win32.NativeMethods
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
[DllImportAttribute("KernelBase.dll", CharSet = CharSet.Auto, BestFitMapping = false, 
	ThrowOnUnmappableChar = true)]
public static HResult PathCchAddBackslash(
	StringBuilder buffer,
	uint bufferSize
)

Parameters

buffer  StringBuilder
A pointer to the path string.

When this function returns successfully, the buffer contains the string with the appended backslash.

This value should not be NULL.

bufferSize  UInt32
The size of the buffer pointed to by buffer, in characters.

Return Value

HResult
This function returns S_OK if the function was successful, S_FALSE if the path string already ends in a backslash, or an error code otherwise.

Remarks

See Also