Função IoWMISetSingleInstance (wdm.h)

A rotina IoWMISetSingleInstance define os valores das propriedades na instância do bloco de dados que corresponde à classe WMI especificada e ao nome da instância.

Sintaxe

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

Parâmetros

[in] DataBlockObject

Ponteiro para um objeto de bloco de dados WMI. O chamador abre o objeto de bloco de dados da classe WMI com a rotina de IoWMIOpenBlock. O objeto deve ser aberto com o WMIGUID_SET direito de acesso.

[in] InstanceName

Especifica o nome da instância do bloco de dados. Esse valor corresponde ao valor da propriedade InstanceName do bloco.

[in] Version

Reservado para uso futuro. Os chamadores devem definir esse parâmetro como zero.

[in] ValueBufferSize

Especifica o tamanho, em bytes, do buffer passado no parâmetro ValueBuffer.

[in] ValueBuffer

Ponteiro para o buffer que contém os novos valores para as propriedades dentro do bloco de dados.

Valor de retorno

A rotina retorna um código NTSTATUS. Os valores de retorno possíveis incluem:

Observações

IoWMISetSingleInstance determina quais drivers podem dar suporte à classe WMI especificada e ao nome da instância e emite uma solicitação IRP_MN_CHANGE_SINGLE_INSTANCE para cada driver. O driver que exporta a instância do bloco de dados com propriedade InstanceName correspondente atualiza sua instância de bloco de dados. Observe que um bloco de dados pode ter propriedades somente leitura e leitura/gravação. Nesse caso, somente as propriedades de leitura/gravação serão atualizadas e STATUS_SUCCESS será retornado.

Os drivers também podem usar a rotina IoWMISetSingleItem para atualizar uma única propriedade dentro da instância de classe.

Requisitos

Consulte também

IRP_MN_CHANGE_SINGLE_INSTANCE

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleItem