Skip to content

Latest commit

 

History

History
149 lines (100 loc) · 5.26 KB

ns-wininet-url_componentsw.md

File metadata and controls

149 lines (100 loc) · 5.26 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:wininet.URL_COMPONENTSW
URL_COMPONENTSW (wininet.h)
Contains the constituent parts of a URL. This structure is used with the InternetCrackUrl and InternetCreateUrl functions. (Unicode)
*LPURL_COMPONENTSW
LPURL_COMPONENTS
LPURL_COMPONENTS structure pointer [WinINet]
URL_COMPONENTS
URL_COMPONENTS structure [WinINet]
URL_COMPONENTSA
URL_COMPONENTSW
_inet_url_components_structure
wininet.url_components
wininet/LPURL_COMPONENTS
wininet/URL_COMPONENTS
wininet/URL_COMPONENTSA
wininet/URL_COMPONENTSW
wininet\url_components.htm
wininet
faebdd29-f746-486b-b779-cceeecac9163
12/05/2018
*LPURL_COMPONENTSW, LPURL_COMPONENTS, LPURL_COMPONENTS structure pointer [WinINet], URL_COMPONENTS, URL_COMPONENTS structure [WinINet], URL_COMPONENTSA, URL_COMPONENTSW, _inet_url_components_structure, wininet.url_components, wininet/LPURL_COMPONENTS, wininet/URL_COMPONENTS, wininet/URL_COMPONENTSA, wininet/URL_COMPONENTSW
wininet.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
URL_COMPONENTSW (Unicode) and URL_COMPONENTSA (ANSI)
Windows
URL_COMPONENTSW, *LPURL_COMPONENTSW
19H1
LPURL_COMPONENTSW
wininet/LPURL_COMPONENTSW
URL_COMPONENTSW
wininet/URL_COMPONENTSW
c++
APIRef
kbSyntax
HeaderDef
Wininet.h
URL_COMPONENTS
URL_COMPONENTSA
URL_COMPONENTSW

URL_COMPONENTSW structure

-description

Contains the constituent parts of a URL. This structure is used with the InternetCrackUrl and InternetCreateUrl functions.

-struct-fields

-field dwStructSize

Size of this structure, in bytes.

-field lpszScheme

Pointer to a string that contains the scheme name.

-field dwSchemeLength

Size of the scheme name, in TCHARs.

-field nScheme

INTERNET_SCHEME value that indicates the Internet protocol scheme.

-field lpszHostName

Pointer to a string that contains the host name.

-field dwHostNameLength

Size of the host name, in TCHARs.

-field nPort

Converted port number.

-field lpszUserName

Pointer to a string value that contains the user name.

-field dwUserNameLength

Size of the user name, in TCHARs.

-field lpszPassword

Pointer to a string that contains the password.

-field dwPasswordLength

Size of the password, in TCHARs.

-field lpszUrlPath

Pointer to a string that contains the URL path.

-field dwUrlPathLength

Size of the URL path, in TCHARs.

-field lpszExtraInfo

Pointer to a string that contains the extra information (for example, ?something or #something).

-field dwExtraInfoLength

Size of the extra information, in TCHARs.

-remarks

For InternetCrackUrl, if a pointer member and its corresponding length member are both zero, that component is not returned. If the pointer member is NULL but the length member is not zero, both the pointer and length members are returned. If both pointer and corresponding length members are nonzero, the pointer member points to a buffer where the component is copied. The component can be un-escaped, depending on the dwFlags parameter of InternetCrackUrl.

For InternetCreateUrl, the pointer members should be NULL if the component is not required. If the corresponding length member is zero, the pointer member is the address of a zero-terminated string. If the length member is not zero, it is the string length of the corresponding pointer member.

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).
 

Note

The wininet.h header defines URL_COMPONENTS 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.

-see-also

InternetCrackUrl

InternetCreateUrl