Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Adds an element to the current collection.
Syntax
HRESULT AddElement(
[in] IAppHostElement* pElement,
[in,
defaultvalue(-1
)] INT cPosition);
Parameters
pElement
A pointer to an IAppHostElement interface.
cPosition
An INT value that represents the position in the collection where pElement should be inserted.
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. |
| 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. |
Remarks
Note
Passing –1 into cPosition results in the item being added to the beginning of the collection except when the mergeAppend attribute is false.
Requirements
| 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 |
See Also
IAppHostElementCollection Interface
IAppHostElementCollection::CreateNewElement Method