Compartir a través de

Función IoWMISetSingleInstance (wdm.h)

  • Artículo

La rutina IoWMISetSingleInstance establece los valores de las propiedades de la instancia de bloque de datos que coincide con el nombre de instancia y la clase WMI especificados.

Sintaxis

NTSTATUS IoWMISetSingleInstance(
  [in] PVOID           DataBlockObject,
  [in] PUNICODE_STRING InstanceName,
  [in] ULONG           Version,
  [in] ULONG           ValueBufferSize,
  [in] PVOID           ValueBuffer
);

Parámetros

[in] DataBlockObject

Puntero a un objeto de bloque de datos WMI. El autor de la llamada abre el objeto de bloque de datos para la clase WMI con la rutina IoWMIOpenBlock . El objeto debe abrirse con el derecho de acceso WMIGUID_SET.

[in] InstanceName

Especifica el nombre de la instancia del bloque de datos. Este valor corresponde al valor de la propiedad InstanceName del bloque.

[in] Version

Reservado para uso futuro. Los autores de llamadas deben establecer este parámetro en cero.

[in] ValueBufferSize

Especifica el tamaño, en bytes, del búfer pasado en el parámetro ValueBuffer .

[in] ValueBuffer

Puntero al búfer que contiene los nuevos valores de las propiedades dentro del bloque de datos.

Valor devuelto

La rutina devuelve un código NTSTATUS. Entre los valores devueltos posibles se incluyen:

Código devuelto Descripción
STATUS_SUCCESS
 La operación se realizó correctamente. Los valores de las propiedades de instancia del bloque de datos WMI se actualizan al contenido del búfer al que apunta el parámetro ValueBuffer .
STATUS_WMI_GUID_NOT_FOUND
 Ningún controlador implementa la clase WMI.
STATUS_WMI_INSTANCE_NOT_FOUND
 Ningún controlador implementa una instancia de la clase WMI con la propiedad InstanceName igual al valor especificado en el parámetro InstanceName .
STATUS_WMI_READ_ONLY
 Todas las propiedades de la clase WMI son de solo lectura.
STATUS_WMI_SET_FAILURE
 El controlador que implementa la instancia del bloque de datos WMI no puede actualizar la instancia.

Comentarios

IoWMISetSingleInstance determina qué controladores pueden admitir la clase WMI y el nombre de instancia especificados, y emite una solicitud de IRP_MN_CHANGE_SINGLE_INSTANCE a cada controlador de este tipo. El controlador que exporta la instancia del bloque de datos con la propiedad InstanceName coincidente actualiza su instancia de bloque de datos. Tenga en cuenta que un bloque de datos puede tener propiedades de solo lectura y de lectura y escritura. En este caso, solo se actualizarán las propiedades de lectura y escritura y se devolverá STATUS_SUCCESS.

Los controladores también pueden usar la rutina IoWMISetSingleItem para actualizar una sola propiedad dentro de la instancia de clase.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows XP y versiones posteriores del sistema operativo Windows.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

IRP_MN_CHANGE_SINGLE_INSTANCE

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleItem