Поделиться через

Функция RasAdminGetErrorString

  • Статья

[Эта функция предоставляется только для обеспечения обратной совместимости с Windows NT Server 4.0. Он возвращает ERROR_CALL_NOT_IMPLEMENTED в Windows Server 2003. Приложения должны использовать функцию MprAdminGetErrorString .]

Функция RasAdminGetErrorString извлекает строку сообщения, соответствующую коду ошибки RAS, возвращенному одной из функций администрирования сервера RAS (RasAdmin). Эти строки сообщений извлекаются из Rasmsg.dll, установленного в составе RAS.

Синтаксис

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

Параметры

ResourceId [in]

Указывает код ошибки, возвращаемый одной из функций RasAdmin. Это значение должно находиться в диапазоне кодов ошибок от RASBASE до RASBASEEND. Они определены в Файле Raserror.h.

lpszString [out]

Указатель на буфер, получающий сообщение об ошибке, соответствующее указанному коду ошибки.

InBufSize [in]

Задает размер буфера lpszString (в символах). Сообщения об ошибках обычно имеют размер не более 80 символов; размер буфера в 512 символов всегда является достаточным.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки. Это значение может быть последним значением ошибки, заданным функциями LoadLibrary, GlobalAlloc или LoadString ; или может быть одним из следующих кодов ошибок.

Значение Значение
ERROR_INVALID_PARAMETER
 Недопустимые параметры ResourceId или lpszString .
ERROR_INSUFFICIENT_BUFFER
 Размер, заданный параметром InBufSize , слишком мал.

Для этой функции нет расширенных сведений об ошибке; не вызывать GetLastError.

Комментарии

Функции RasAdmin могут возвращать коды ошибок, которые не входят в диапазон, поддерживаемый функцией RasAdminGetErrorString . Например, функции RasAdmin могут возвращать коды ошибок, определенные в Lmerr.h и Winerror.h. Перед вызовом RasAdminGetErrorString убедитесь, что код ошибки находится в диапазоне RASBASE и RASBASEEND, как определено в Файле Raserror.h.

Требования

Требование Значение
Окончание поддержки клиентов
 Windows 2000 Professional
Окончание поддержки сервера
 Windows 2000 Server
Заголовок
Rassapi.h
Библиотека
Rassapi.lib
DLL
Rassapi.dll

См. также раздел

Общие сведения о службе удаленного доступа (RAS)

Функции администрирования сервера RAS

LoadLibrary

GlobalAlloc

LoadString