3.1.4.29.2 Item (Opnum 4)

The Item method is received by the server in an RPC_REQUEST packet. In response, the server returns a section group that matches the specified index.

 [propget, id(DISPID_VALUE)] HRESULT Item(
   [in] VARIANT varIndex,
   [out, retval] IAppHostSectionGroup** ppSectionGroup
 );

varIndex: A VARIANT index that specifies the section group. If it is of type integer, the index is a zero-based index to the collection. If it is of type string, the index is the name of the section group to retrieve.

ppSectionGroup: Contains the selected IAppHostSectionGroup.

Return Values: The server MUST return zero if it successfully processes the message that is received from the client. In this case, *ppSectionGroup is not NULL. If processing fails, the server MUST return a nonzero HRESULT code as defined in [MS-ERREF]. The following table below 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

Description

0X00000000

NO_ERROR

The operation completed successfully.

0X80070585

ERROR_INVALID_INDEX

The integer index specified by varIndex is invalid, or the section group with name specified by varIndex could not be found.