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