3.18.4.7 IStringCollection::Clear (Opnum 14)

  • Article

The IStringCollection::Clear (opnum 14) method removes all items from the collection.

 HRESULT Clear();

This method has no parameters.

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.

If the collection is read-only, the server SHOULD return WU_E_NOT_SUPPORTED (0x80240037).

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

This method SHOULD empty the List ADM element and set the value of the Count ADM element to 0.