IoWMISuggestInstanceName-Funktion (wdm.h)

Die IoWMISuggestInstanceName Routine wird verwendet, um anzufordern, dass WMI einen Basisnamen vorschlägt, den ein Treiber zum Erstellen von WMI-Instanznamen 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 IoRegisterDeviceInterfacezurückgegeben wird.

[in] CombineNames

Wenn TRUE-, werden die zurückgegebenen vorgeschlagenen Namen die PhysicalDeviceObject- und SymbolicLinkName Informationen kombiniert.

[out] SuggestedInstanceName

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

Rückgabewert

IoWMISuggestInstanceName gibt einen Statuscode aus der folgenden Liste zurück:

Bemerkungen

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

Anforderungen

Siehe auch

IoWMIAllocateInstanceIds