Edit

Share via

IProviderPublishing::RemoveInstance method (functiondiscoveryprovider.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.]

Deletes an existing function instance.

Syntax

HRESULT RemoveInstance(
  [in] SystemVisibilityFlags enumVisibilityFlags,
  [in] const WCHAR           *pszSubCategory,
  [in] const WCHAR           *pszProviderInstanceIdentity
);

Parameters

[in] enumVisibilityFlags

A SystemVisibilityFlags enumeration value which specifies the visibility of the function instance which the provider is about to delete. It is up to the provider whether or not to honor this setting, however the current user visibility can be used to allow processes running in a non-Administrator security context to still be able to remove function instances.

[in] pszSubCategory

The subcategory string of the function instance.

[in] pszProviderInstanceIdentity

The provider instance identifier.

Return value

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

Return code Description
S_OK
 The method completed successfully.
E_INVALIDARG
 One of the parameters contains an invalid argument.
E_POINTER
 The pSiteInfo, pszSubCategory, or pszProviderInstanceIdentity parameter is NULL.

Requirements

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

See also

IProviderPublishing