###User Defined Function###
_IEFormGetObjByName

###Description###
Returns an object reference to a Form by name.

###Syntax###
#include <IE.au3>
_IEFormGetObjByName ( ByRef $o_object, $s_name [, $i_index = 0] )


###Parameters###
@@ParamTable@@
$o_object
	Object variable of an InternetExplorer.Application, Window or Frame object
$s_name
	Specifies the name of the Form you wish to match
$i_index
	[optional] If Form name occurs more than once, specifies instance by 0-based index
		 0 (Default) or positive integer returns an indexed instance
		-1 returns a collection of the specified Forms
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	an object variable pointing to the Form object, @extended = form count.
Failure:	sets the @error flag to non-zero.
@error:	3 ($_IEStatus_InvalidDataType) - Invalid Data Type
	7 ($_IEStatus_NoMatch) - No Match
@extended:	Contains invalid parameter number
@@End@@


###Remarks###
If the desired form does not have a name or ID, <a href="_IEFormGetCollection.htm">_IEFormGetCollection()</a> to get a reference by index.


###Related###
_IEFormGetCollection, _IEFormReset, _IEFormSubmit


###Example###
@@IncludeExample@@
