Share via

3.1.4.1.1 GetContainerData (Opnum 4)

  • Article

A client calls this method to obtain tracking information for instance containers across all conglomerations.

 HRESULT GetContainerData(
   [out] DWORD* nContainers,
   [out, size_is(,(*nContainers))] 
     ContainerData** aContainerData
 );

nContainers: A pointer to a variable that, upon successful completion, MUST contain the number of elements in aContainerData.

aContainerData: A pointer to a variable that, upon successful completion, MUST contain an array of zero or more ContainerData (section 2.2.3) structures. An array with zero elements MUST be represented by null.

Return Values: This method MUST return S_OK (0x00000000) on success and a failure result (as specified in [MS-ERREF] section 2.1) on failure.

When this method is invoked, the server MUST attempt to return an array of ContainerData structures, one for each instance container tracked by the server, or fail the call if it cannot.