IFunctionDiscovery::RemoveInstance, méthode (functiondiscoveryapi.h)

[La découverte de fonctions peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Supprime le instance de fonction spécifié, en fonction de la catégorie et de la sous-catégorie.

Syntaxe

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

Paramètres

[in] enumSystemVisibility

Valeur SystemVisibilityFlags qui spécifie si la fonction instance est supprimée à l’échelle du système ou uniquement pour l’utilisateur actuel.

[in] pszCategory

Catégorie de la fonction instance. Consultez Définitions de catégorie.

[in] pszSubCategory

La sous-catégorie de la fonction instance à supprimer. Consultez Définitions de sous-catégorie. Ce paramètre peut être NULL.

[in] pszCategoryIdentity

Chaîne d’identificateur du fournisseur instance. Cette chaîne est retournée à partir de GetProviderInstanceID.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code/valeur de retour	Description
S_OK	La commande s'est correctement terminée.
E_INVALIDARG	La valeur de pszCategoryIdentity n’est pas valide.
E_OUTOFMEMORY	La méthode ne peut pas allouer la mémoire nécessaire pour effectuer cette opération.
E_ACCESSDENIED	L’autorisation d’accès de l’utilisateur est insuffisante pour effectuer l’action demandée.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	La valeur de pszCategory ou pszSubCategory est inconnue.

Notes

L’autorisation d’accès pour modifier HKEY_LOCAL_MACHINE\SYSTEM clés de Registre est requise pour ajouter ou supprimer des instances de fonction à l’aide du fournisseur de Registre (niveaux d’accès Administrateur ou Utilisateur actif). L’utilisateur doit disposer d’un accès administrateur pour supprimer une fonction instance l’ensemble du système.

Note Cette méthode n’est pas prise en charge par tous les fournisseurs.

 

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	functiondiscoveryapi.h
DLL	FunDisc.dll

Voir aussi

IFunctionDiscovery