DEVPROP_TYPE_NTSTATUS

Der DEVPROP_TYPE_NTSTATUS Bezeichner stellt den Basisdatentypbezeichner für die NTSTATUS-Statuscodewerte 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 Eingabeparameter der Funktion 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 Parameter PropertyBufferSize 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:

• Fügen Sie ein bitweises OR der FORMAT_MESSAGE_FROM_SYSTEM-Kennzeichnung und das FORMAT_MESSAGE_FROM_HMODULE Flag in den Wert des Dwflags-Parameters ein.

• Legen Sie den lpSource-Parameter auf ein Handle auf das modulNtDLL.dll fest, bei dem es sich um die Quelle für den beschreibenden Text handelt.

• Legen Sie den dwMessageID-Parameter auf den Fehlercodewert fest.

• Legen Sie die anderen Optionen und Parameter entsprechend fest, um den beschreibenden Text abzurufen.

Requirements

Siehe auch

DEVPROP_TYPE_ERROR

DEVPROP_TYPEMOD_ARRAY