Share via

3.1.4.1.3 GetComponentDataByContainerAndCLSID (Opnum 6)

  • Article

A client calls this method to obtain tracking information for a single component that has component instances in an instance container.

 HRESULT GetComponentDataByContainerAndCLSID(
   [in] DWORD idContainer,
   [in] GUID clsid,
   [out] ComponentData** ppComponentData
 );

idContainer: The container legacy identifier of an instance container.

clsid: A pointer to the CLSID of a component.

ppComponentData: A pointer to a variable that, upon successful completion, MUST contain a pointer to a single ComponentData (section 2.2.4) structure.

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 verify that the idContainer parameter identifies a tracked instance container and that the CLSID received in the clsid parameter identifies a component that is instantiated in that instance container. If not, the server MUST fail the call; otherwise, the server MUST return a single ComponentData structure that represents the component instantiated in the instance container and return success.