3.2.4.2.29.9 CreateFileScreenCollection (Opnum 15)

  • Article

The CreateFileScreenCollection method creates an empty collection. This creates a location where callers can add file screens.

 [id(FSRM_DISPID_FILESCREEN_MANAGER | 0x07)] HRESULT CreateFileScreenCollection(
   [out, retval] IFsrmCommittableCollection** collection
 );

collection: Pointer to an IFsrmCommittableCollection interface pointer (section 3.2.4.2.3) that, upon completion, points to an empty IFsrmCommittableCollection specific to file screen objects. A caller MUST release the collection received when the caller is done with it.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80070057

E_INVALIDARG

The collection parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that collection is not NULL.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

The server MUST create a new collection object and set the collection parameter to the new collection's IFsrmCommittableCollection interface object.