Fonction IoWMISuggestInstanceName (wdm.h)

Article
02/27/2024

La routine IoWMISuggestInstanceName est utilisée pour demander à WMI de suggérer un nom de base qu’un pilote peut utiliser pour générer des noms de instance WMI pour l’appareil.

Syntaxe

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

Paramètres

[in, optional] PhysicalDeviceObject

S’il est fourni, pointe vers l’objet de périphérique physique du pilote.

[in, optional] SymbolicLinkName

S’il est fourni, pointe vers le nom de lien symbolique retourné par IoRegisterDeviceInterface.

[in] CombineNames

Si la valeur est TRUE , les noms suggérés retournés combinent les informations PhysicalDeviceObject et SymbolicLinkName .

[out] SuggestedInstanceName

Pointeur vers une mémoire tampon qui, une fois la saisie terminée, contient un UNICODE_STRING contenant le nom instance suggéré. L’appelant est responsable de libérer cette mémoire tampon quand elle n’est plus nécessaire.

Valeur retournée

IoWMISuggestInstanceName retourne un code status à partir de la liste suivante :

Code de retour	Description
STATUS_SUCCESS	Indique que WMI a réussi à exécuter cette fonction.
STATUS_UNSUCCESSFUL	Indique que les services WMI ne sont pas disponibles.
STATUS_INSUFFICIENT_RESOURCES	Indique que les ressources disponibles étaient insuffisantes pour fournir à l’appelant une mémoire tampon contenant la chaîne Unicode.
STATUS_NO_MEMORY	Indique que les ressources disponibles étaient insuffisantes pour fournir à l’appelant une mémoire tampon contenant la chaîne Unicode.

Remarques

Si le paramètre CombineNames a la valeur TRUE , physicalDeviceObject et SymbolicLinkName doivent être spécifiés. Sinon, un seul d’entre eux doit être spécifié.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

IoWMIAllocateInstanceIds

Partager via