DEVPROP_TYPE_NTSTATUS
Der DEVPROP_TYPE_NTSTATUS-Bezeichner stellt den Basisdatentypbezeichner für die NTSTATUS-status Codewerte dar, die in Ntstatus.h definiert sind.
Bemerkungen
In Windows Vista und höheren Versionen von Windows definiert das einheitliche Geräteeigenschaftenmodell auch einen DEVPROP_TYPE_ERROR Basisdatentypbezeichner für Microsoft Win32-Fehlercodewerte.
Sie können DEVPROP_TYPE_NTSTATUS nur mit dem DEVPROP_TYPEMOD_ARRAY Eigenschaft-Datentyp-Modifizierer kombinieren.
Festlegen einer Eigenschaft dieses Typs
Um eine Eigenschaft festzulegen, deren Basisdatentyp DEVPROP_TYPE_NTSTATUS ist, rufen Sie die entsprechende SetupDiSetXxx-Eigenschaftsfunktion auf, und legen Sie die Funktionseingabeparameter wie folgt fest:
Legen Sie den PropertyType-Parameter auf DEVPROP_TYPE_NTSTATUS fest.
Legen Sie den PropertyBuffer-Parameter auf einen Zeiger auf einen Puffer fest, der mindestens einen NTSTATUS-Wert enthalten kann.
Legen Sie den PropertyBufferSize-Parameter auf sizeof(NTSTATUS) fest.
Legen Sie die verbleibenden Funktionsparameter entsprechend fest, um die -Eigenschaft festzulegen.
Abrufen des beschreibenden Texts für einen NTSTATUS-Fehlercodewert
Um den beschreibenden Text abzurufen, der einem NTSTATUS-Fehlercodewert zugeordnet ist, rufen Sie die FormatMessage-Funktion (dokumentiert im Windows SDK) wie folgt auf:
Schließen Sie ein bitweises OR des FORMAT_MESSAGE_FROM_SYSTEM-Flags und des FORMAT_MESSAGE_FROM_HMODULE-Flags in den Wert des dwflags-Parameters ein.
Legen Sie den lpSource-Parameter auf ein Handle für das modulNtDLL.dll fest, das die Quelle für den beschreibenden Text ist.
Legen Sie den dwMessageID-Parameter auf den Fehlercodewert fest.
Legen Sie die anderen Optionen und Parameter entsprechend fest, um den beschreibenden Text abzurufen.
Requirements (Anforderungen)
Version |
Windows Vista und höhere Versionen von Windows. |
Header |
Devpropdef.h (devpropdef.h einschließen) |