IInternetProtocolRoot::Start (Windows Embedded CE 6.0)

  • Article

1/6/2010

This method starts the operation.

Syntax

HRESULT Start(
  LPCWSTR szUrl,
  IInternetProtocolSink* pOIProtSink,
  IInternetBindInfo* pOIBindInfo,
  DWORD grfPI,
  HANDLE_PTR dwReserved
);

Parameters

  • szUrl
    [in] Address of a string value that contains the URL. For a pluggable MIME filter, this parameter contains the MIME type.
  • pOIProtSink
    [in] Address of the protocol sink provided by the client.
  • pOIBindInfo
    [in] Address of the IInternetBindInfo interface from which the protocol gets download-specific information.
  • grfPI
    [in] Unsigned long integer value that contains the flags that determine if the method only parses or if it parses and downloads the URL. This can be one of the PI_FLAGS values.
  • dwReserved
    [in] For pluggable MIME filters, contains the address of a PROTOCOLFILTERDATA structure. Otherwise, it is reserved and must be set to NULL.

Return Value

Returns one of the values shown in the following table.

Value Description

S_OK

Success.

E_PENDING

The operation started and will complete asynchronously.

INET_E_USE_DEFAULT_PROTOCOLHANDLER

The handler cannot handle this URL, so the default handler should be used. See the Remarks section below.

INET_E_xxx

Internet-specific errors. For additional information, see the URL Moniker Error Codes definitions.

Remarks

INET_E_USE_DEFAULT_PROTOCOLHANDLER can be returned only by a pluggable namespace handler or MIME filter. Only a single, permanently registered asynchronous pluggable protocol handler can be assigned to a particular scheme (such as FTP), so there are no other handlers to default to.

Requirements

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IInternetProtocolRoot
IInternetBindInfo