GetExternal method

Gets the host's IDispatch interface.

Syntax

HRESULT retVal = object.GetExternal(ppDispatch);

Parameters

• ppDispatch [out]
  Type: IDispatch

  A pointer to a variable that receives an IDispatch interface pointer for the host application.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If the host exposes an automation interface, it can provide a reference to MSHTML through ppDispatch.

If the method implementation does not supply an IDispatch, set ppDispatch to NULL, even if the method fails or returns S_FALSE.