3.38.4.12 IUpdateSearcher::Online (Opnum 21)

  • Article

The IUpdateSearcher::Online (opnum 21) method retrieves whether a search performed by using this interface is an online search.

 HRESULT Online(
   [out, retval] VARIANT_BOOL* retval
 );

retval: MUST be set either to VARIANT_TRUE if the search operation can contact the server or to VARIANT_FALSE if it uses local data only.

Return Values: The method MUST return information in an HRESULT data structure. The severity bit in the structure identifies the following conditions:

  • If the severity bit is set to 0, the method completed successfully.

  • If the severity bit is set to 1, the method failed and encountered a fatal error.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

This method SHOULD return the value of the Online ADM element.