DEVPROP_TYPE_NTSTATUS
L'identificatore DEVPROP_TYPE_NTSTATUS rappresenta l'identificatore del tipo di dati di base per i valori del codice di stato NTSTATUS definiti in Ntstatus.h.
Commenti
In Windows Vista e versioni successive di Windows, il modello di proprietà del dispositivo unificato definisce anche un identificatore di tipo di dati di base DEVPROP_TYPE_ERROR per i valori del codice di errore di Microsoft Win32.
È possibile combinare DEVPROP_TYPE_NTSTATUS solo con il modificatore property-data-type DEVPROP_TYPEMOD_ARRAY .
Impostazione di una proprietà di questo tipo
Per impostare una proprietà il cui tipo di dati di base è DEVPROP_TYPE_NTSTATUS, chiamare la funzione di proprietà SetupDiSetXxx corrispondente e impostare i parametri di input della funzione come indicato di seguito:
Impostare il parametro PropertyType su DEVPROP_TYPE_NTSTATUS.
Impostare il parametro PropertyBuffer su un puntatore a un buffer che può contenere almeno un valore NTSTATUS.
Impostare il parametro PropertyBufferSize su sizeof(NTSTATUS).
Impostare i parametri della funzione rimanenti in base alle esigenze per impostare la proprietà .
Recupero del testo descrittivo per un valore di codice di errore NTSTATUS
Per recuperare il testo descrittivo associato a un valore di codice di errore NTSTATUS, chiamare la funzione FormatMessage (documentata in Windows SDK) come indicato di seguito:
Includere un OR bit per bit del flag FORMAT_MESSAGE_FROM_SYSTEM e il flag FORMAT_MESSAGE_FROM_HMODULE nel valore del parametro dwflags .
Impostare il parametro lpSource su un handle sul modulo NtDLL.dll , ovvero l'origine per il testo descrittivo.
Impostare il parametro dwMessageID sul valore del codice di errore.
Impostare le altre opzioni e parametri in base alle esigenze per recuperare il testo descrittivo.
Requisiti
Versione |
Windows Vista e versioni successive di Windows. |
Intestazione |
Devpropdef.h (includere Devpropdef.h) |