###User Defined Function###
_IEFormElementGetObjByName

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

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


###Parameters###
@@ParamTable@@
$o_object
	Object variable of an InternetExplorer.Application, Form object
$s_name
	Specifies the name of the Form Element you wish to match
$i_index
	[optional] If the Form Element 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 Form Elements
@@End@@

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


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


###Related###
_IEFormElementGetCollection, _IEFormElementGetValue, _IEFormElementSetValue, _IEFormSubmit


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