Contents Index Topic Contents
	Previous Topic: IInternetProtocolRoot::Resume Next Topic: IInternetProtocolRoot::Suspend

IInternetProtocolRoot::Start

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

Starts the operation.

• Returns one of the following values:

  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.
  INET_E_xxx	Internet-specific errors.

szUrl

String value containing the URL. For a pluggable MIME filter, this parameter contains the MIME type.

pOIProtSink

Address of the protocol sink provided by the client.

pOIBindInfo

Address of the IInternetBindInfo interface from which the protocol gets download-specific information.

grfPI

DWORD value containing the flags that determine if the method only parses or if it parses and downloads the URL. Can be one of the PI_FLAGS values.

dwReserved

For pluggable MIME filters, contains the address of a PROTOCOLFILTERDATA structure. Otherwise, it is reserved and must be set to zero.

INET_E_USE_DEFAULT_PROTOCOLHANDLER can be returned only by a pluggable name-space 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.

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.