Warnung C6381

Die Herunterfahren-API "function" erfordert ein gültiges dwReason- oder lpMessage-Gerät.

Hinweise

Diese Warnung wird ausgegeben, wenn InitiateSystemShutdownEx sie aufgerufen wird:

• Ohne einen gültigen Grund für das Herunterfahren (dwReason) zu übergeben. Wenn dwReason der Parameter null ist, ist die Standardeinstellung ein nicht definiertes Herunterfahren. Standardmäßig ist es auch ein ungeplantes Herunterfahren. Sie sollten einen der Ursachencodes für das Herunterfahren des Systems für diesen Parameter verwenden.

• Ohne eine Meldung zum Herunterfahren (lpMessage) zu übergeben.

Es wird empfohlen, beim Aufrufen dieser API geeignete Parameter zu verwenden, um Systemadministratoren bei der Ermittlung der Ursache des Herunterfahrens zu helfen.

Codeanalysename: SHUTDOWN_API

Beispiel

Der folgende Code generiert diese Warnung, da dwReason null ist und lpMessage null ist:

void f()
{
  //...
  BOOL bRet;
  bRet = InitiateSystemShutdownEx( NULL,
                                   NULL, // message
                                   0,
                                   FALSE,
                                   TRUE,
                                   0);  // shutdown reason
  // ...
}

Um diese Warnung zu korrigieren, geben Sie dwReason und lpMessage wie im folgenden Code dargestellt an:

#include <windows.h>
void f()
{
  //...
  BOOL bRet;
  bRet = InitiateSystemShutdownEx( NULL,
                               "Hardware Failure",  // message
                               0,
                               FALSE,
                               TRUE,
                               SHTDN_REASON_MAJOR_HARDWARE ); // reason
  // ...
}