ISearchProtocol2::Init Method

Initializes a protocol handler.

Syntax

HRESULT Init(      
    TIMEOUT_INFO *pTimeoutInfo,
    IProtocolHandlerSite *pProtocolHandlerSite,
    PROXY_INFO *pProxyInfo
);

Parameters

  • pTimeoutInfo
    [in]  Pointer to a TIMEOUT_INFO structure that contains information about connection time-outs.
  • pProtocolHandlerSite
    [in]  Pointer to an IProtocolHandlerSite interface that enables protocol handlers to access IFilters within the filter host.
  • pProxyInfo
    [in]  Pointer to a PROXY_INFO structure that contains information about the proxy settings necessary for accessing items in the content source.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

After the protocol handler is created, this method is called to perform any initialization specific to the protocol handler. This method is not called again.

Because the protocol host may unexpectedly terminate before calling ISearchProtocol::ShutDown, protocol handlers with persistent information, such as temporary files and registry entries, should do an initial clean-up of resources previously opened in this method before starting the current instance.