3.18.4.8 IStringCollection::Copy (Opnum 15)

  • Article

The IStringCollection::Copy (opnum 15) method creates a deep read-write copy of the collection from this instance.

 HRESULT Copy(
   [out, retval] IStringCollection** retval
 );

retval: A read-write IStringCollection (section 3.18.4) instance containing a copy of the strings in this collection, in the same order.

Return Values: The method MUST return information in an HRESULT data structure. The severity bit in the structure identifies the following conditions:

  • If the severity bit is set to 0, the method completed successfully.

  • If the severity bit is set to 1, the method failed and encountered a fatal error.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

This method  SHOULD create a new object implementing the IStringCollection interface and initialize the copy's ADM as follows:

  • ReadOnly: Set to FALSE.

  • List: A copy of the original server's List ADM element.

  • Count: Set to the value of the original server's Count ADM element.