ShlwApiPathStripToRoot Method

Note: This API is now obsolete.
Removes all file and directory elements in a path except for the root information.

Note: Misuse of this function can lead to a buffer overrun. We recommend the use of the safer PathCchStripToRoot(StringBuilder, UInt32) function in its place.

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("ShlwApi.dll", CharSet = CharSet.Auto, BestFitMapping = false, 
	ThrowOnUnmappableChar = true, SetLastError = true)]
[ObsoleteAttribute("Misuse of this function can lead to a buffer overrun. We recommend the use of the safer NativeMethods.PathCchStripToRoot function in its place.", 
	false)]
public static bool PathStripToRoot(
	StringBuilder path
)

Parameters

path  StringBuilder
A pointer to a null-terminated string of length MAX_PATH that contains the path to be converted.

When this function returns successfully, this string contains only the root information taken from that path.

Return Value

Boolean
Returns if a valid drive letter was found in the path, or otherwise.

Remarks

See Also