Edit

Share via

IFunctionDiscovery::RemoveInstance method (functiondiscoveryapi.h)

  • Article

[Function Discovery is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Removes the specified function instance, based on category and subcategory.

Syntax

HRESULT RemoveInstance(
  [in] SystemVisibilityFlags enumSystemVisibility,
  [in] const WCHAR           *pszCategory,
  [in] const WCHAR           *pszSubCategory,
  [in] const WCHAR           *pszCategoryIdentity
);

Parameters

[in] enumSystemVisibility

A SystemVisibilityFlags value that specifies whether the function instance is removed system-wide or only for the current user.

[in] pszCategory

The category of the function instance. See Category Definitions.

[in] pszSubCategory

The subcategory of the function instance to be removed. See Subcategory Definitions. This parameter can be NULL.

[in] pszCategoryIdentity

The provider instance identifier string. This string is returned from GetProviderInstanceID.

Return value

Possible return values include, but are not limited to, the following.

Return code/value Description
S_OK
 The method completed successfully.
E_INVALIDARG
 The value of pszCategoryIdentity is invalid.
E_OUTOFMEMORY
 The method is unable to allocate the memory required to perform this operation.
E_ACCESSDENIED
 The user has insufficient access permission to perform the requested action.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 The value of pszCategory or pszSubCategory is unknown.

Remarks

Access permission to change HKEY_LOCAL_MACHINE\SYSTEM registry keys is required in order to add or remove function instances using the registry provider (Administrator or Power User access levels). The user must have Administrator access to remove a function instance system-wide.

Note  This method is not supported by all providers.
 

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header functiondiscoveryapi.h
DLL FunDisc.dll

See also

IFunctionDiscovery