IoWMISuggestInstanceName-Funktion (wdm.h)

Artikel
02/29/2024

Die IoWMISuggestInstanceName-Routine wird verwendet, um anzufordern, dass WMI einen Basisnamen vorschlägt, den ein Treiber zum Erstellen von WMI-instance Namen für das Gerät verwenden kann.

Syntax

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

Parameter

[in, optional] PhysicalDeviceObject

Zeigt bei Angabe auf das physische Geräteobjekt des Treibers.

[in, optional] SymbolicLinkName

Wenn angegeben, verweist auf den symbolischen Linknamen, der von IoRegisterDeviceInterface zurückgegeben wird.

[in] CombineNames

Bei TRUE kombinieren die zurückgegebenen vorgeschlagenen Namen die Informationen PhysicalDeviceObject und SymbolicLinkName .

[out] SuggestedInstanceName

Ein Zeiger auf einen Puffer, der nach erfolgreichem Abschluss einen UNICODE_STRING enthält, der den vorgeschlagenen instance Namen enthält. Der Aufrufer ist dafür verantwortlich, diesen Puffer frei zu geben, wenn er nicht mehr benötigt wird.

Rückgabewert

IoWMISuggestInstanceName gibt einen status Code aus der folgenden Liste zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Gibt an, dass WMI diese Funktion erfolgreich abschließen konnte.
STATUS_UNSUCCESSFUL	Gibt an, dass die WMI-Dienste nicht verfügbar sind.
STATUS_INSUFFICIENT_RESOURCES	Gibt an, dass nicht genügend Ressourcen verfügbar waren, um dem Aufrufer einen Puffer mit der Unicode-Zeichenfolge bereitzustellen.
STATUS_NO_MEMORY	Gibt an, dass nicht genügend Ressourcen verfügbar waren, um dem Aufrufer einen Puffer mit der Unicode-Zeichenfolge bereitzustellen.

Hinweise

Wenn der CombineNames-ParameterTRUE ist, müssen sowohl PhysicalDeviceObject als auch SymbolicLinkName angegeben werden. Andernfalls sollte nur eine davon angegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Weitere Informationen

IoWMIAllocateInstanceIds

Freigeben über