Share via

3.1.4.21.8 GetContainerIDFromConglomerationID (Opnum 10)

  • Article

This method is called by a client to find the container identifier for the single instance container for a conglomeration.

 HRESULT GetContainerIDFromConglomerationID(
   [in] GUID* ConglomerationIdentifier,
   [out] GUID* ContainerIdentifier
 );

ConglomerationIdentifier: The conglomeration identifier of a conglomeration.

ContainerIdentifier: A pointer to a variable that, upon successful completion, MUST be set to the container identifier of the single instance container for the conglomeration specified in ConglomerationIdentifier.

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. All failure results MUST be treated identically.

Upon receiving a call to this method, the server MUST verify that there exists a conglomeration with the conglomeration identifier specified in ConglomerationIdentifier, and fail the call if not.

The server then MUST verify that there exists exactly one instance container for the conglomeration, and fail the call if not.

The server then MUST attempt to set the value referenced by ContainerIdentifier to the container identifier of the single instance container for the conglomeration, and fail if it cannot.