IUriBuilder::RemoveProperties method
Removes the specified properties as well as any derived properties.
Syntax
HRESULT RemoveProperties(
[in] DWORD dwPropertyMask
);
Parameters
dwPropertyMask [in]
DWORD that contains a combination of the following flags:
Uri_HAS_USER_NAME (0x00000800)
Remove Uri_PROPERTY_USER_NAME.
Uri_HAS_PASSWORD (0x00000040)
Remove Uri_PROPERTY_PASSWORD.
Uri_HAS_HOST (0x00000020)
Remove Uri_PROPERTY_HOST.
Uri_HAS_PORT (0x00008000)
Remove Uri_PROPERTY_PORT.
Uri_HAS_PATH (0x00000080)
Remove Uri_PROPERTY_PATH.
Uri_HAS_QUERY (0x00000100)
Remove Uri_PROPERTY_QUERY.
Uri_HAS_FRAGMENT (0x00000010)
Remove Uri_PROPERTY_FRAGMENT.
Return value
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
RemoveProperties was introduced in Windows Internet Explorer 7.
Compound properties (such as Uri_PROPERTY_AUTHORITY, Uri_PROPERTY_USER_INFO, and Uri_PROPERTY_PATH_AND_QUERY) and sub-properties (such as Uri_PROPERTY_DOMAIN and Uri_PROPERTY_EXTENSION) are also removed when their associated property primitives are removed. Uri_PROPERTY_ABSOLUTE_URI and Uri_PROPERTY_DISPLAY_URI are also invalidated when subcomponents are modified.
Uri_PROPERTY_SCHEME and Uri_PROPERTY_SCHEME_NAME cannot be removed. Use SetSchemeName to modify the scheme component.
Requirements
Minimum supported client |
Windows XP with SP2 |
Minimum supported server |
Windows Server 2003 |
Product |
Internet Explorer 7 |
Header |
Urlmon.h |
IDL |
Urlmon.idl |
DLL |
Urlmon.dll |