WlanReasonCodeToString-Funktion (wlanapi.h)

Die WlanReasonCodeToString-Funktion ruft eine Zeichenfolge ab, die einen angegebenen Ursachencode beschreibt.

Syntax

DWORD WlanReasonCodeToString(
  [in] DWORD  dwReasonCode,
  [in] DWORD  dwBufferSize,
  [in] PWCHAR pStringBuffer,
       PVOID  pReserved
);

Parameter

[in] dwReasonCode

Ein WLAN_REASON_CODE Wert, dessen Zeichenfolgenbeschreibung angefordert wird.

[in] dwBufferSize

Die Größe des Puffers, der zum Speichern der Zeichenfolge in WCHAR verwendet wird. Wenn die Grundcodezeichenfolge länger als der Puffer ist, wird sie abgeschnitten und NULL beendet. Wenn dwBufferSize größer als die tatsächliche Menge an Arbeitsspeicher ist, die pStringBuffer zugeordnet ist, tritt im aufrufenden Programm eine Zugriffsverletzung auf.

[in] pStringBuffer

Zeiger auf einen Puffer, der die Zeichenfolge empfängt. Der Aufrufer muss vor dem Aufrufen von WlanReasonCodeToString Arbeitsspeicher pStringBuffer zuweisen.

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf eine konstante Zeichenfolge.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn eine der folgenden Bedingungen auftritt:
  • dwBufferSize ist 0.
  • pStringBuffer ist NULL.
  • pReserved ist nicht NULL.
Andere
Verschiedene RPC- und andere Fehlercodes. Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wlanapi.h (wlanapi.h einschließen)
Bibliothek Wlanapi.lib
DLL Wlanapi.dll
Verteilbare Komponente Wlan-API für Windows XP mit SP2

Weitere Informationen

WLAN_REASON_CODE