Converts a Microsoft MS-DOS path to a canonicalized URL.
Syntax
HRESULT UrlCreateFromPath(
LPCTSTR pszPath,
LPTSTR pszUrl,
LPDWORD pcchUrl,
DWORD dwReserved
);
Parameters
- pszPath
-
[in] A null-terminated string of maximum length INTERNET_MAX_URL_LENGTH that contains the MS-DOS path.
- pszUrl
-
[out] A buffer used to return the URL.
- pcchUrl
-
[in, out] The length of pszUrl.
- dwReserved
-
[in] Reserved. Set this parameter to NULL.
Return Value
Returns S_FALSE if pszPath is already in URL format. In this case, pszPath will simply be copied to pszUrl. Otherwise, it returns S_OK if successful or a standard OLE error value if not.
Function Information
| Minimum DLL Version | shlwapi.dll version 5.0 or later |
|---|
| Custom Implementation | No |
|---|
| Header | shlwapi.h |
|---|
| Import library | shlwapi.lib |
|---|
| Minimum operating systems |
Windows 2000, Windows NT 4.0 with Internet Explorer 5, Windows 98, Windows 95 with Internet Explorer 5 |
|---|
| Unicode | Implemented as
ANSI and Unicode versions. |
|---|