Export (0) Print
Expand All

IELaunchURL function

Opens a URL in an Windows Internet Explorer process with an appropriate integrity level, and returns information about the new process.

Syntax


HRESULT IELaunchURL(
  _In_      LPCWSTR pszUrl,
  _In_      LPPROCESS_INFORMATION pProcInfo,
  _In_opt_  LPIELAUNCHURL lpInfo
);

Parameters

pszUrl [in]

A pointer to a NULL-terminated string containing the URL to be opened. If this parameter is NULL, the user's home page is opened.

pProcInfo [in]

A pointer to a PROCESS_INFORMATION structure that receives information about the process.

lpInfo [in, optional]

A pointer to an IELAUNCHURLINFO structure; can be NULL.

Return value

Returns S_OK if the URL is successfully opened in a new Internet Explorer process, or an error value otherwise.

Examples

The following example shows a function that opens Internet Explorer processes with an appropriate integrity level.


HRESULT LaunchIE(LPCWSTR pszURL)
{
    PROCESS_INFORMATION procInfo;
    IELAUNCHURLINFO launchInfo;
    launchInfo.cbSize = sizeof(IELAUNCHURLINFO);
    launchInfo.dwCreationFlags = NULL;

    HRESULT hr = IELaunchURL(pszURL, &procInfo, &launchInfo);
    if (SUCCEEDED(hr))
    {
        WaitForInputIdle(procInfo.hProcess, 2000);
        CloseHandle(procInfo.hProcess);
        CloseHandle(procInfo.hThread);
    }
    return hr;
}

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Product

Internet Explorer 7

Header

Iepmapi.h

Library

Iepmapi.lib

DLL

Ieframe.dll

 

 

Show:
© 2014 Microsoft