RasAdminGetErrorString-Funktion

[Diese Funktion wird nur für die Abwärtskompatibilität mit Windows NT Server 4.0 bereitgestellt. Es gibt ERROR_CALL_NOT_IMPLEMENTED unter Windows Server 2003 zurück. Anwendungen sollten die Funktion MprAdminGetErrorString verwenden.]

Die RasAdminGetErrorString-Funktion ruft eine Nachrichtenzeichenfolge ab, die einem RAS-Fehlercode entspricht, der von einer der RAS-Serververwaltungsfunktionen (RasAdmin) zurückgegeben wird. Diese Nachrichtenzeichenfolgen werden aus dem Rasmsg.dll abgerufen, der als Teil von RAS installiert ist.

Syntax

DWORD RasAdminGetErrorString(
  _In_  UINT  ResourceId,
  _Out_ WCHAR *lpszString,
  _In_  DWORD InBufSize
);

Parameter

ResourceId [in]

Gibt einen Fehlercode an, der von einer der RasAdmin-Funktionen zurückgegeben wird. Dieser Wert muss im Bereich der Fehlercodes von RASBASE bis RASBASEEND liegen. Diese werden in Raserror.h definiert.

lpszString [out]

Zeiger auf einen Puffer, der die Fehlermeldung empfängt, die dem angegebenen Fehlercode entspricht.

InBufSize [in]

Gibt die Größe des lpszString-Puffers in Zeichen an. Fehlermeldungen sind in der Regel maximal 80 Zeichen lang. Eine Puffergröße von 512 Zeichen ist immer ausreichend.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode. Dieser Wert kann ein letzter Fehlerwert sein, der von den Funktionen LoadLibrary, GlobalAlloc oder LoadString festgelegt wird. oder es kann einer der folgenden Fehlercodes sein.

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Die Parameter ResourceId oder lpszString sind ungültig.
ERROR_INSUFFICIENT_BUFFER	Die vom InBufSize-Parameter angegebene Größe ist zu klein.

Es gibt keine erweiterten Fehlerinformationen für diese Funktion. Rufen Sie GetLastError nicht auf.

Bemerkungen

Die RasAdmin-Funktionen können Fehlercodes zurückgeben, die sich nicht im von der RasAdminGetErrorString-Funktion unterstützten Bereich befinden. Beispielsweise können die RasAdmin-Funktionen Fehlercodes zurückgeben, die in Lmerr.h und Winerror.h definiert sind. Überprüfen Sie vor dem Aufrufen von RasAdminGetErrorString, ob sich der Fehlercode im Bereich RASBASE bis RASBASEEND befindet, wie in Raserror.h definiert.

Anforderungen

Anforderung	Wert
Ende des Supports (Client)	Windows 2000 Professional
Ende des Supports (Server)	Windows 2000 Server
Header	Rassapi.h
Bibliothek	Rassapi.lib
DLL	Rassapi.dll

Siehe auch

Ras-Dienst (Ras) – Übersicht

RAS Server-Verwaltungsfunktionen

LoadLibrary

Globalalloc

LoadString