Compartilhar via

Função IoWMISuggestInstanceName (wdm.h)

  • Artigo

A rotina IoWMISuggestInstanceName é usada para solicitar que o WMI sugira um nome base que um driver possa usar para criar nomes de instância WMI para o dispositivo.

Sintaxe

NTSTATUS IoWMISuggestInstanceName(
  [in, optional] PDEVICE_OBJECT  PhysicalDeviceObject,
  [in, optional] PUNICODE_STRING SymbolicLinkName,
  [in]           BOOLEAN         CombineNames,
  [out]          PUNICODE_STRING SuggestedInstanceName
);

Parâmetros

[in, optional] PhysicalDeviceObject

Se fornecido, aponta para o objeto de dispositivo físico do driver.

[in, optional] SymbolicLinkName

Se fornecido, aponta para o nome do link simbólico retornado de IoRegisterDeviceInterface.

[in] CombineNames

Se TRUE , os nomes sugeridos retornados combinarão as informações PhysicalDeviceObject e SymbolicLinkName .

[out] SuggestedInstanceName

Um ponteiro para um buffer que, após a conclusão bem-sucedida, conterá um UNICODE_STRING que contém o nome da instância sugerida. O chamador é responsável por liberar esse buffer quando ele não é mais necessário.

Retornar valor

IoWMISuggestInstanceName retorna um código status da seguinte lista:

Código de retorno Descrição
STATUS_SUCCESS
 Indica que o WMI foi capaz de concluir essa função com êxito.
STATUS_UNSUCCESSFUL
 Indica que os serviços WMI não estão disponíveis.
STATUS_INSUFFICIENT_RESOURCES
 Indica que recursos insuficientes estavam disponíveis para fornecer ao chamador um buffer que contém a cadeia de caracteres Unicode.
STATUS_NO_MEMORY
 Indica que recursos insuficientes estavam disponíveis para fornecer ao chamador um buffer que contém a cadeia de caracteres Unicode.

Comentários

Se o parâmetro CombineNames for TRUE , PhysicalDeviceObject e SymbolicLinkName deverão ser especificados. Caso contrário, apenas um deles deve ser especificado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
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

IoWMIAllocateInstanceIds