Edit

Share via

PARSEDURLW structure (shlwapi.h)

  • Article

Used by the ParseURL function to return the parsed URL.

Syntax

typedef struct tagPARSEDURLW {
  DWORD   cbSize;
  LPCWSTR pszProtocol;
  UINT    cchProtocol;
  LPCWSTR pszSuffix;
  UINT    cchSuffix;
  UINT    nScheme;
} PARSEDURLW, *PPARSEDURLW;

Members

cbSize

Type: DWORD

[in] The size of the structure, in bytes. The calling application must set this member before calling the ParseURL function.

pszProtocol

Type: LPCTSTR

[out] A pointer to the beginning of the protocol part of the URL.

cchProtocol

Type: UINT

[out] The number of characters in the URL's protocol section.

pszSuffix

Type: LPCTSTR

[out] A pointer to the section of the URL that follows the protocol and colon (':'). For file URLs, the function also skips the leading "//" characters.

cchSuffix

Type: UINT

[out] The number of characters in the URL's suffix.

nScheme

Type: UINT

[out] A value from the URL_SCHEME enumeration that specifies the URL's scheme.

Remarks

Note

The shlwapi.h header defines PARSEDURL 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, Windows Server 2003 [desktop apps only]
Header shlwapi.h