Método IFunctionDiscovery::RemoveInstance (functiondiscoveryapi.h)

[La detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Quita la instancia de función especificada, en función de la categoría y la subcategoría.

Sintaxis

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

Parámetros

[in] enumSystemVisibility

Valor SystemVisibilityFlags que especifica si la instancia de función se quita en todo el sistema o solo para el usuario actual.

[in] pszCategory

Categoría de la instancia de función. Consulte Definiciones de categorías.

[in] pszSubCategory

Subcategoría de la instancia de función que se va a quitar. Consulte Subcategory Definitions (Definiciones de subcategoría). Este parámetro puede ser NULL.

[in] pszCategoryIdentity

Cadena de identificador de instancia del proveedor. Esta cadena se devuelve desde GetProviderInstanceID.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código o valor devuelto	Descripción
S_OK	El método se completó correctamente.
E_INVALIDARG	El valor de pszCategoryIdentity no es válido.
E_OUTOFMEMORY	El método no puede asignar la memoria necesaria para realizar esta operación.
E_ACCESSDENIED	El usuario no tiene permiso de acceso suficiente para realizar la acción solicitada.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	El valor de pszCategory o pszSubCategory es desconocido.

Comentarios

Se requiere permiso de acceso para cambiar HKEY_LOCAL_MACHINE\SYSTEM claves del Registro para agregar o quitar instancias de función mediante el proveedor del Registro (niveles de acceso de administrador o usuario avanzado). El usuario debe tener acceso de administrador para quitar una instancia de función en todo el sistema.

Nota Este método no es compatible con todos los proveedores.

 

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	functiondiscoveryapi.h
Archivo DLL	FunDisc.dll

Consulte también

IFunctionDiscovery