IUriBuilder::CreateUri method

Returns a new IUri object based on modifications to the original IUri.

Syntax

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

Parameters

  • dwCreateFlags [in]
    DWORD that combines Uri_CREATE flags, which control the creation of the IUri object. Refer to the CreateUri function for a description of these flags. Pass the value of (DWORD)-1 to use the same flags as were specified when the original IUri object was created.

  • dwAllowEncodingPropertyMask [in]
    Reserved. Must be set to 0.

  • 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

CreateUri 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

See also

IUriBuilder

Reference

CreateUriSimple

CreateUriWithFlags