Compartir a través de

Método Provider::D eleteInstance(constCInstance&,long) (provider.h)

  • Artículo

[La clase Provider forma parte del marco del proveedor de WMI que ahora se considera en estado final y no habrá más desarrollo, mejoras o actualizaciones disponibles para problemas no relacionados con la seguridad que afecten a estas bibliotecas. Las API de MI se deben usar para todo el nuevo desarrollo.]

WMI llama al método DeleteInstance para eliminar una instancia.

Sintaxis

HRESULT DeleteInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

Parámetros

[ref] newInstance

Instancia que se va a eliminar.

lFlags

Máscara de bits de marcas con información sobre la operación de eliminación. Este es el valor especificado por el cliente en la función IWbemServices::D eleteInstance .

WMI controla la marca siguiente (y filtrada):

  • WBEM_FLAG_RETURN_IMMEDIATELY

Valor devuelto

La implementación predeterminada del proveedor de marcos de este método devuelve WBEM_E_PROVIDER_NOT_CAPABLE a la función que realiza la llamada. La función IWbemServices::D eleteInstance enumera los valores devueltos más comunes, aunque puede elegir devolver cualquier código de retorno COM.

Comentarios

WMI invoca DeleteInstance cuando un cliente llama a IWbemServices::D eleteInstance en una clase. Por lo tanto, debe implementar DeleteInstance si el proveedor de marcos admite la eliminación de instancias. En la lista siguiente se describe una implementación común de DeleteInstance:

  1. Determine qué instancia solicitó el cliente leyendo las propiedades de clave con uno de los métodos Get para CInstance, como CInstance::GetCHString.
  2. Elimine la instancia.
Para obtener más información sobre cómo eliminar instancias, vea IWbemServices::D eleteInstance.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado provider.h (include FwCommon.h)
Library FrameDyn.lib
Archivo DLL FrameDynOS.dll; FrameDyn.dll