Edit

Share via

PARSEDURLA structure (shlwapi.h)

  • Article

Used by the ParseURL function to return the parsed URL.

Syntax

typedef struct tagPARSEDURLA {
  DWORD  cbSize;
  LPCSTR pszProtocol;
  UINT   cchProtocol;
  LPCSTR pszSuffix;
  UINT   cchSuffix;
  UINT   nScheme;
} PARSEDURLA, *PPARSEDURLA;

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