Compartilhar via


Função IoWMIHandleToInstanceName (wdm.h)

A rotina de IoWMIHandleToInstanceName determina o nome da instância da instância da classe WMI implementada pelo driver especificado por um identificador de arquivo.

Sintaxe

NTSTATUS IoWMIHandleToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  HANDLE          FileHandle,
  [out] PUNICODE_STRING InstanceName
);

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.

[in] FileHandle

Especifica um identificador de arquivo. A rotina retorna o nome da instância correspondente ao driver representado pelo identificador de arquivo.

[out] InstanceName

Ponteiro para a estrutura de UNICODE_STRING que a rotina usa para retornar o nome da instância. O chamador libera o buffer retornado dentro de UNICODE_STRING.

Valor de retorno

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

Código de retorno Descrição
STATUS_SUCCESS
A operação foi bem-sucedida. A rotina preenche a estrutura de UNICODE_STRING apontada pelo parâmetro InstanceName com o nome da instância.
STATUS_WMI_INSTANCE_NOT_FOUND
O driver não implementa nenhuma instância da classe WMI especificada por DataBlockObject.

Requisitos

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

Consulte também

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock