Compartir a través de

Función IoWMISuggestInstanceName (wdm.h)

  • Artículo

La rutina IoWMISuggestInstanceName se usa para solicitar que WMI sugiera un nombre base que un controlador puede usar para compilar nombres de instancia de WMI para el dispositivo.

Sintaxis

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

Parámetros

[in, optional] PhysicalDeviceObject

Si se proporciona, apunta al objeto de dispositivo físico del controlador.

[in, optional] SymbolicLinkName

Si se proporciona, apunta al nombre del vínculo simbólico devuelto desde IoRegisterDeviceInterface.

[in] CombineNames

Si es TRUE , los nombres sugeridos devueltos combinarán la información PhysicalDeviceObject y SymbolicLinkName .

[out] SuggestedInstanceName

Un puntero a un búfer que al finalizar correctamente contendrá un UNICODE_STRING que contiene el nombre de instancia sugerido. El autor de la llamada es responsable de liberar este búfer cuando ya no es necesario.

Valor devuelto

IoWMISuggestInstanceName devuelve un código de estado de la lista siguiente:

Código devuelto Descripción
STATUS_SUCCESS
 Indica que WMI pudo completar correctamente esta función.
STATUS_UNSUCCESSFUL
 Indica que los servicios WMI no están disponibles.
STATUS_INSUFFICIENT_RESOURCES
 Indica que los recursos insuficientes estaban disponibles para proporcionar al autor de la llamada un búfer que contiene la cadena Unicode.
STATUS_NO_MEMORY
 Indica que los recursos insuficientes estaban disponibles para proporcionar al autor de la llamada un búfer que contiene la cadena Unicode.

Comentarios

Si el parámetro CombineNames es TRUE , se deben especificar PhysicalDeviceObject y SymbolicLinkName . De lo contrario, solo se debe especificar una de ellas.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

IoWMIAllocateInstanceIds