Metodo IFunctionDiscovery::RemoveInstance (functiondiscoveryapi.h)

[Individuazione funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Rimuove l'istanza di funzione specificata, in base alla categoria e alla sottocategoria.

Sintassi

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

Parametri

[in] enumSystemVisibility

Valore SystemVisibilityFlags che specifica se l'istanza della funzione viene rimossa a livello di sistema o solo per l'utente corrente.

[in] pszCategory

Categoria dell'istanza della funzione. Vedere Definizioni di categoria.

[in] pszSubCategory

Sottocategoria dell'istanza della funzione da rimuovere. Vedere Definizioni sottocategorie. Questo parametro può essere NULL.

[in] pszCategoryIdentity

Stringa di identificatore dell'istanza del provider. Questa stringa viene restituita da GetProviderInstanceID.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice/valore restituito	Descrizione
S_OK	Metodo completato correttamente.
E_INVALIDARG	Il valore di pszCategoryIdentity non è valido.
E_OUTOFMEMORY	Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione.
E_ACCESSDENIED	L'utente ha un'autorizzazione di accesso insufficiente per eseguire l'azione richiesta.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Il valore di pszCategory o pszSubCategory è sconosciuto .

Commenti

L'autorizzazione di accesso per modificare HKEY_LOCAL_MACHINE\SYSTEM chiavi del Registro di sistema è necessaria per aggiungere o rimuovere istanze di funzione usando il provider del Registro di sistema (livelli di accesso amministratore o Power User). L'utente deve avere accesso amministratore per rimuovere un'istanza di funzione a livello di sistema.

Nota Questo metodo non è supportato da tutti i provider.

 

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryapi.h
DLL	FunDisc.dll

Vedi anche

IFunctionDiscovery