Função IoWMISetSingleItem (wdm.h)

  • Artigo

A rotina IoWMISetSingleItem define uma única propriedade na instância do bloco de dados que corresponde à classe WMI especificada e ao nome da instância.

Sintaxe

NTSTATUS IoWMISetSingleItem(
  [in] PVOID           DataBlockObject,
  [in] PUNICODE_STRING InstanceName,
  [in] ULONG           DataItemId,
  [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 para a classe WMI com a rotina 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] DataItemId

Especifica a ID do item de dados para a propriedade a ser definida. O valor desse parâmetro corresponde ao valor declarado no qualificador WmiDataId para a propriedade .

[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 o novo valor para a propriedade especificada pelo parâmetro DataItemId .

Retornar valor

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

Código de retorno Descrição
STATUS_SUCCESS
 A operação foi realizada com êxito. O valor da propriedade na instância do bloco de dados WMI é atualizado para o conteúdo do buffer apontado pelo parâmetro ValueBuffer .
STATUS_WMI_GUID_NOT_FOUND
 Nenhum drivers implementa a classe WMI.
STATUS_WMI_INSTANCE_NOT_FOUND
 Nenhum driver implementa uma instância do bloco de dados WMI com a propriedade InstanceName igual ao valor especificado no parâmetro InstanceName .
STATUS_WMI_ITEMID_NOT_FOUND
 A classe WMI não contém uma propriedade com a ID do item de dados igual ao valor de DataItemId.
STATUS_WMI_READ_ONLY
 A ID do item de dados no bloco de dados é somente leitura.
STATUS_WMI_SET_FAILURE
 O driver que implementa a instância do bloco de dados WMI não pode atualizar a propriedade especificada por DataItemId.

Comentários

IoWMISetSingleItem determina quais drivers podem dar suporte à classe WMI especificada e ao nome da instância. Ele emite uma solicitação de IRP_MN_CHANGE_SINGLE_ITEM para cada driver desse tipo. O driver que exporta a instância do bloco de dados com a propriedade InstanceName correspondente atualiza a propriedade especificada na instância do bloco de dados.

Os drivers também podem usar IoWMISetSingleInstance para atualizar todas as propriedades da instância da classe WMI simultaneamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP e versões posteriores do sistema operacional Windows.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

IRP_MN_CHANGE_SINGLE_ITEM

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleInstance