IRequiredExtensions::GetFirstExtension method

The IRequiredExtensions::GetFirstExtension method enables the snap-in to specify the first extension snap-in its list of required extension snap-ins.

Syntax


HRESULT GetFirstExtension(
  [out] LPCLSID pExtCLSID
);

Parameters

pExtCLSID [out]

A pointer to the CLSID of the first snap-in in the list of required extension snap-ins.

Return value

This method can return one of these values.

S_OK

The CLSID for the first required snap-in was successfully returned.

S_FALSE

If the return value is not S_OK, there are no required extension snap-ins for this snap-in. MMC does not add any required extension snap-ins.

Remarks

MMC calls this method if IRequiredExtensions::EnableAllExtensions returns a value that is not S_OK.

If this method returns S_OK, MMC adds the extension snap-in specified by pExtCLSID and then calls IRequiredExtensions::GetNextExtension to get the next extension snap-in in the list. If any other value is returned, MMC treats the required list as if it were empty by not adding the extension snap-in specified by pExtCLSID and not calling IRequiredExtensions::GetNextExtension.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Mmc.h

See also

IRequiredExtensions
IRequiredExtensions::EnableAllExtensions
IRequiredExtensions::GetNextExtension

 

 

Show: