HRESULT getElementsByName( BSTR v, IHTMLElementCollection **pelColl );
- [in] A BSTR that specifies the value of a NAME attribute.
- [out, retval] A pointer to a collection of objects with the same NAME attribute value.
Returns S_OK if successful, or an error value otherwise.
When you use the IHTMLDocument3::getElementsByName method, all elements in the document that have the specified NAME attribute or ID attribute value are returned.
Elements that support both the NAME attribute and the ID attribute are included in the collection returned by the IHTMLDocument3::getElementsByName method, but elements with a NAME expando are not included in the collection; therefore, this method cannot be used to retrieve custom tags by name.