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