IUriBuilder::CreateUriSimple method
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.
-
Allow encoding of Uri_PROPERTY_USER_NAME.
-
Allow encoding of Uri_PROPERTY_PASSWORD.
-
Allow encoding of Uri_PROPERTY_HOST.
-
Allow encoding of Uri_PROPERTY_PATH.
-
Allow encoding of Uri_PROPERTY_QUERY.
-
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 |
|
|
IDL |
|
|
DLL |
|
See also
- IUriBuilder
- Reference
- CreateUri
- CreateUriWithFlags