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

See also

IUriBuilder