IAppHostElementCollection::AddElement Method

Adds an element to the current collection.

Syntax

HRESULT AddElement(  
   [in] IAppHostElement* pElement,  
   [in,  
   defaultvalue(-1  
)] INT cPosition);

pElement
A pointer to an IAppHostElement interface.

cPosition
An INT value that represents the position in the collection where pElement should be inserted.

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.
ERROR_INVALID_INDEX	Indicates that `cPosition` is greater than the number of entries in the collection.
ERROR_FILE_NOT_FOUND	Indicates that the element does not have the required attribute set.

Note

Passing –1 into cPosition results in the item being added to the beginning of the collection except when the mergeAppend attribute is false.

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - 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 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Ahadmin.h