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.