IUriBuilder::CreateUriSimple method

2016-07-13

Returns a new IUri object based on modifications to the original IUri, using the original Uri_CREATE flags.

Syntax

HRESULT CreateUriSimple(
  [in]  DWORD     dwAllowEncodingPropertyMask,
  [in]  DWORD_PTR dwReserved,
  [out] IUri      **ppIUri
);

Parameters

dwAllowEncodingPropertyMask [in]

DWORD that may contain a combination of the following flags, or zero. Reserved characters in these properties may be percent encoded, if required.

Uri_HAS_USER_NAME (0x00000800)

Allow encoding of Uri_PROPERTY_USER_NAME.

Uri_HAS_PASSWORD (0x00000040)

Allow encoding of Uri_PROPERTY_PASSWORD.

Uri_HAS_HOST (0x00000020)

Allow encoding of Uri_PROPERTY_HOST.

Uri_HAS_PATH (0x00000080)

Allow encoding of Uri_PROPERTY_PATH.

Uri_HAS_QUERY (0x00000100)

Allow encoding of Uri_PROPERTY_QUERY.

Uri_HAS_FRAGMENT (0x00000010)

Allow encoding of Uri_PROPERTY_FRAGMENT.

dwReserved [in]

Reserved. Must be set to 0.

ppIUri [out]

Address of pointer variable of type IUri that receives the new object.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

CreateUriSimple was introduced in Windows Internet Explorer 7.

If no changes are made, this method may return a pointer to the original IUri object (after incrementing the reference count).

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

Dela via