Start method

Starts the operation.

Syntax

HRESULT retVal = object.Start(szUrl, pOIProtSink, pOIBindInfo, grfPI, dwReserved);

Parameters

• szUrl [in]
  Type: LPCWSTR

  The address of a string value that contains the URL. For a pluggable MIME filter, this parameter contains the MIME type.

• pOIProtSink [in]
  Type: IInternetProtocolSink

  The address of the protocol sink provided by the client.

• pOIBindInfo [in]
  Type: IInternetBindInfo

  The address of the IInternetBindInfo interface that the protocol gets download-specific information from.

• grfPI [in]
  Type: DWORD

  An unsigned long integer value that contains the flags to determine whether the method parses or parses and downloads the URL. This can be one of the PI_FLAGS values.

• dwReserved [in]
  Type: HANDLE_PTR

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

Remarks

INET_E_USE_DEFAULT_PROTOCOLHANDLER can only be returned 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.

To use INET_E_USE_DEFAULT_PROTOCOLHANDLER, the pluggable protocol handler object must support aggregation. For more information, see COM Aggregation.