Funzione IoWMISuggestInstanceName (wdm.h)
La routine IoWMISugGestInstanceName viene usata per richiedere che WMI suggerisca un nome di base che un driver può usare per compilare nomi di istanza WMI per il dispositivo.
Sintassi
NTSTATUS IoWMISuggestInstanceName(
[in, optional] PDEVICE_OBJECT PhysicalDeviceObject,
[in, optional] PUNICODE_STRING SymbolicLinkName,
[in] BOOLEAN CombineNames,
[out] PUNICODE_STRING SuggestedInstanceName
);
Parametri
[in, optional] PhysicalDeviceObject
Se specificato, punta all'oggetto dispositivo fisico del driver.
[in, optional] SymbolicLinkName
Se specificato, punta al nome del collegamento simbolico restituito da IoRegisterDeviceInterface.
[in] CombineNames
Se TRUE i nomi suggeriti restituiti combinano le informazioni PhysicalDeviceObject e SymbolicLinkName .
[out] SuggestedInstanceName
Puntatore a un buffer che al termine del completamento conterrà un UNICODE_STRING contenente il nome dell'istanza suggerita. Il chiamante è responsabile della liberazione di questo buffer quando non è più necessario.
Valore restituito
IoWMISuggestInstanceName restituisce un codice di stato dall'elenco seguente:
| Codice restituito | Descrizione |
|---|---|
|
Indica che WMI è stato in grado di completare correttamente questa funzione. |
|
Indica che i servizi WMI non sono disponibili. |
|
Indica che sono state disponibili risorse insufficienti per fornire al chiamante un buffer contenente la stringa Unicode. |
|
Indica che sono state disponibili risorse insufficienti per fornire al chiamante un buffer contenente la stringa Unicode. |
Commenti
Se il parametro CombineNames è TRUE , è necessario specificare PhysicalDeviceObject e SymbolicLinkName . In caso contrario, è necessario specificare solo uno di essi.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |