Freigeben über

IoWMISuggestInstanceName-Funktion (wdm.h)

  • Artikel

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