iapphostelement-getelementbyname-method.md

title	IAppHostElement::GetElementByName Method
description	Learn how the IAppHostElement::GetElementByName method gets a requested child element from the current element.
ms.date	10/07/2016
ms.assetid	1fbd772c-733f-b950-cb44-db5f3ae5ec8a

IAppHostElement::GetElementByName Method

Gets a requested child element from the current element.

Syntax

HRESULT GetElementByName(  
   [in,  
   string] BSTR bstrSubName,  
   [out,  
   retval] IAppHostElement** ppElement  
);  

Parameters

bstrSubName
A BSTR that contains the name of the requested child element.

ppElement
A pointer to a pointer for an IAppHostElement interface.

Return Value

An HRESULT. Possible values include, but are not limited to, those in the following table.

Value	Description
S_OK	Indicates that the operation was successful.

Requirements

Type	Description
Client	- IIS 7.0 on [!INCLUDEwinvista] - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on [!INCLUDEwinsrv2008] - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - [!INCLUDEiisexp75], [!INCLUDEiisexp80], [!INCLUDEiisexp100]
Header	Ahadmin.h

See Also

IAppHostElement Interface