Compartir a través de


Método Provider::P utInstance(constCInstance&,long) (provider.h)

[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.]

El método PutInstance actualiza una instancia.

Sintaxis

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

Parámetros

[ref] newInstance

Instancia que se actualiza.

lFlags

Máscara de bits de marcas con información sobre la operación de actualización. Este es el valor especificado por el cliente en el método IWbemServices::P utInstance .

WMI controla la marca siguiente (y filtrada):

  • WBEM_FLAG_RETURN_IMMEDIATELY
Los valores lFlags válidos son:
  • WBEM_FLAG_CREATE_ONLY
  • WBEM_FLAG_CREATE_OR_UPDATE
  • WBEM_FLAG_UPDATE_ONLY

Valor devuelto

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

Comentarios

WMI invoca PutInstance cuando un cliente llama a IWbemServices::P utInstance en la clase . Debe implementar PutInstance si el proveedor de marcos actualiza las instancias. En la lista siguiente se describe una implementación común de PutInstance:

  1. Examine las propiedades de clave pasadas por el cliente con los métodos Get para CInstance, como CInstance::GetCHString.

    La implementación debe determinar si el proveedor admite los cambios solicitados por el cliente.

  2. Cree o actualice el objeto administrado adecuado, según sea necesario.
  3. Devuelve el valor devuelto adecuado.

    Si el proveedor no admite los cambios solicitados por el cliente, debe devolver un código de error adecuado. Para obtener una lista completa de códigos de error válidos, consulte IWbemServices::P utInstance.

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