windows中目录字符串处理函数, MSDN里有使用的例子

PathSearchAndQualify Function

---

Determines if a given path is correctly formatted and fully qualified.

Syntax

BOOL PathSearchAndQualify(      
    LPCTSTR pcszPath,
    LPTSTR pszFullyQualifiedPath,
    UINT cchFullyQualifiedPath
);

Parameters

pcszPath

[in] Pointer to a null-terminated string of maximum length MAX_PATH that contains the path to search.

pszFullyQualifiedPath

[out] Pointer to a null-terminated string of maximum length MAX_PATH that contains the path to be referenced.

cchFullyQualifiedPath

[in] Width of the path pointed to by pszFullyQualifiedPath, in characters.

Return Value

Returns TRUE if the path is qualified, or FALSE otherwise.

PathSetDlgItemPath Function

---

Sets the text of a child control in a window or dialog box, using PathCompactPath to make sure the path fits in the control.

Syntax

void PathSetDlgItemPath(      
    HWND hDlg,
    int id,
    LPCSTR pszPath
);

Parameters

hDlg

[in] Handle to the dialog box or window.

id

[in] Identifier of the control.

pszPath

[in] Pointer to a null-terminated string of maximum length MAX_PATH that contains the path to set in the control.

Return Value

No return value.

PathSkipRoot Function

---

Parses a path, ignoring the drive letter or Universal Naming Convention (UNC) server/share path parts.

Syntax

LPTSTR PathSkipRoot(      
    LPCTSTR pszPath
);

Parameters

pszPath

[in, out] Pointer to a null-terminated string of maximum length MAX_PATH that contains the path to parse.

Return Value

Returns the address of the beginning of the subpath that follows the root (drive letter or UNC server/share).

PathUndecorate Function

---

Removes the decoration from a path string.

Syntax

void PathUndecorate(      
    LPTSTR pszPath
);

Parameters

pszPath

[in] Null-terminated string that contains the path. When the function returns, pszPath points to the undecorated string.

Return Value

No return value.

Remarks

A decoration consists of a pair of square brackets with one or more digits in between, inserted immediately after the base name and before the file name extension.

Example

The following table illustrates how strings are modified by PathUndecorate.

Initial String	Undecorated String
C:\Path\File[5].txt	C:\Path\File.txt
C:\Path\File[12]	C:\Path\File
C:\Path\File.txt	C:\Path\File.txt
C:\Path\[3].txt	C:\Path\[3].txt

PathStripPath Function

---

Removes the path portion of a fully qualified path and file.

Syntax

void PathStripPath(      
    LPTSTR pszPath
);

Parameters

pszPath

[in, out] Pointer to a null-terminated string of maximum length MAX_PATH that contains the path and file name that will have the path portion removed.

Return Value

No return value.

PathStripToRoot Function

---

Removes all parts of the path except for the root information.

Syntax

BOOL PathStripToRoot(      
    LPTSTR szRoot
);

Parameters

szRoot

[in, out] Pointer to a null-terminated string of maximum length MAX_PATH that contains the path to be converted.

Return Value

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