PathRemoveArgsA function (shlwapi.h)
Removes any arguments from a given path.
Syntax
void PathRemoveArgsA(
[in, out] LPSTR pszPath
);
Parameters
[in, out] pszPath
Type: LPTSTR
Pointer to a null-terminated string of length MAX_PATH that contains the path from which to remove arguments.
Return value
None
Remarks
This function should not be used on generic command path templates (from users or the registry), but rather it should be used only on templates that the application knows to be well formed.
Examples
#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"
void main( void )
{
// Path with arguments.
char buffer_1[ ] = "c:\\a\\b\\FileA Arg1 Arg2";
char *lpStr1;
lpStr1 = buffer_1;
// Path before "PathRemoveArgs".
cout << "Path before calling \"PathRemoveArgs\": " << lpStr1 << endl;
// Call function "PathRemoveArgs".
PathRemoveArgs(lpStr1);
// Path after "PathRemoveArgs".
cout << "Path after calling \"PathRemoveArgs\": " << lpStr1 << endl;
}
OUTPUT:
==================
Path before calling "PathRemoveArgs": c:\a\b\FileA Arg1 Arg2
Path after calling "PathRemoveArgs": c:\a\b\FileA
Note
The shlwapi.h header defines PathRemoveArgs as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional, Windows XP [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | shlwapi.h |
Library | Shlwapi.lib |
DLL | Shlwapi.dll (version 4.71 or later) |