IFunctionDiscovery::RemoveInstance-Methode (functiondiscoveryapi.h)

[Funktionsermittlung ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Entfernt die angegebene Funktion instance basierend auf Kategorie und Unterkategorie.

Syntax

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

Parameter

[in] enumSystemVisibility

Ein SystemVisibilityFlags-Wert, der angibt, ob die Funktion instance systemweit oder nur für den aktuellen Benutzer entfernt wird.

[in] pszCategory

Die Kategorie der Funktion instance. Weitere Informationen finden Sie unter Kategoriedefinitionen.

[in] pszSubCategory

Die Unterkategorie der Funktion instance entfernt werden. Siehe Unterkategoriedefinitionen. Dieser Parameter kann NULL sein.

[in] pszCategoryIdentity

Der Anbieter instance Bezeichnerzeichenfolge. Diese Zeichenfolge wird von GetProviderInstanceID zurückgegeben.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG	Der Wert von pszCategoryIdentity ist ungültig.
E_OUTOFMEMORY	Die -Methode kann den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen.
E_ACCESSDENIED	Der Benutzer verfügt über unzureichende Zugriffsberechtigungen, um die angeforderte Aktion auszuführen.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Der Wert von pszCategory oder pszSubCategory ist unbekannt.

Hinweise

Die Zugriffsberechtigung zum Ändern HKEY_LOCAL_MACHINE\SYSTEM Registrierungsschlüssel ist erforderlich, um Funktionsinstanzen mithilfe des Registrierungsanbieters (Administrator- oder Power User-Zugriffsebenen) hinzuzufügen oder zu entfernen. Der Benutzer muss über Administratorzugriff verfügen, um eine Funktion instance systemweit entfernen zu können.

Hinweis Diese Methode wird nicht von allen Anbietern unterstützt.

 

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	functiondiscoveryapi.h
DLL	FunDisc.dll

Weitere Informationen

IFunctionDiscovery