FindBehavior method

Requests that the specified Dynamic HTML (DHTML) behavior be instantiated.

Syntax

HRESULT retVal = object.FindBehavior(bstrBehavior, bstrBehaviorUrl, pSite, ppBehavior);

Parameters

• bstrBehavior [in]
  Type: BSTR

  A string that specifies the name of the requested behavior.

• bstrBehaviorUrl [in]
  Type: BSTR

  A string that specifies the URL of the requested behavior.

• pSite [in]
  Type: IElementBehaviorSite

  A pointer to the host's IElementBehaviorSite interface.

• ppBehavior [out, retval]
  Type: IElementBehavior

  A pointer that returns the IElementBehavior interface.

Return value

Type: HRESULT

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

Remarks

After the Dynamic HTML (DHTML) behavior is instantiated, MSHTML calls the IElementBehavior::Init method.

Specify the case of the bstrBehavior parameter to be all caps when you use this method with element behaviors; for attached behaviors, specify the bstrBehavior parameter in lowercase. Because the bstrBehavior parameter has a specific case based on the type of behavior, you must take precautions when this parameter is used in a string comparison: either the case of the string should be forced, or a case–insensitive comparison should be used.