Item (Opnum 5)

The Item method is received by the server in an RPC_REQUEST packet. In response, the server returns the IAppHostElement object that corresponds to the specific index parameter.

 [propget, id(DISPID_VALUE)] HRESULT Item(
   [in] VARIANT cIndex,
   [out, retval] IAppHostElement** ppSection

cIndex: A VARIANT, which is used to specify the IAppHostElement object to retrieve. If the VARIANT is of type integer, the index is a zero-based index to the collection of IAppHostElement objects, where 0 indicates the first IAppHostElement object, 1 the second, and so on. If the VARIANT is of type string, the index is the name of the IAppHostElement object that is retrieved.

ppSection: Contains an IAppHostElement object, if found.

Return Values: The server MUST return zero if it successfully processes the message that is received from the client. In this case, *ppSection is not NULL. If processing fails, the server MUST return a nonzero HRESULT code as defined in [MS-ERREF]. The following table describes the error conditions that MUST be handled and the corresponding error codes. A server MAY return additional implementation-specific error codes.

Return value/code




The operation completed successfully.



The integer index specified by cIndex is invalid or the element with name specified by cIndex could not be found.



Not enough memory is available to process this command.



Configuration data or schema on the server are malformed or corrupted.