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:
-
Remove Uri_PROPERTY_USER_NAME.
-
Remove Uri_PROPERTY_PASSWORD.
-
Remove Uri_PROPERTY_HOST.
-
Remove Uri_PROPERTY_PORT.
-
Remove Uri_PROPERTY_PATH.
-
Remove Uri_PROPERTY_QUERY.
-
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 |
|
|
IDL |
|
|
DLL |
|
See also