3.1.4.12.2 Collection (Opnum 4)

  • Article

The Collection method is received by the server in an RPC_REQUEST packet. In response, the server returns an IAppHostElementCollection that represents a collection of "collection IAppHostElement" objects. If the specific IAppHostElement does not support this type of child object, it indicates this in the return.

 [propget] HRESULT Collection(
   [out, retval] IAppHostElementCollection** ppCollection
 );

ppCollection: Contains an IAppHostElementCollection that represents the collection child elements. If the specific IAppHostElement does not support this type of child element, this parameter is NULL.

Return Values: The server MUST return zero if it successfully processes the message that is received from the client. 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

Description

0X00000000

NO_ERROR

The operation completed successfully.

0X80070057

ERROR_INVALID_PARAMETER

One or more parameters are incorrect or null.

0X80070013

ERROR_INVALID_DATA

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