RasAdminGetErrorString 函数

[此函数仅用于向后兼容 Windows NT Server 4.0。 它在 Windows Server 2003 上返回ERROR_CALL_NOT_IMPLEMENTED。 应用程序应使用 MprAdminGetErrorString 函数。]

RasAdminGetErrorString 函数检索一个消息字符串,该字符串对应于 RAS 服务器管理 (RasAdmin) 函数返回的 RAS 错误代码。 这些消息字符串是从作为 RAS 的一部分安装的Rasmsg.dll中检索的。

语法

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。

如果函数失败,则返回值为错误代码。 此值可以是 LoadLibraryGlobalAllocLoadString 函数设置的最后一个错误值;也可以是以下错误代码之一。

含义
ERROR_INVALID_PARAMETER
ResourceIdlpszString 参数无效。
ERROR_INSUFFICIENT_BUFFER
InBufSize 参数指定的大小太小。

此函数没有扩展的错误信息;不要调用 GetLastError

备注

RasAdmin 函数可以返回不在 RasAdminGetErrorString 函数支持的范围内的错误代码。 例如,RasAdmin 函数可以返回 Lmerr.h 和 Winerror.h 中定义的错误代码。 在调用 RasAdminGetErrorString 之前,请验证错误代码是否在 Raserror.h 中定义的 RASBASE 到 RASBASEEND 的范围内。

要求

要求
客户端支持终止
Windows 2000 Professional
终止服务器支持
Windows 2000 Server
标头
Rassapi.h

Rassapi.lib
DLL
Rassapi.dll

另请参阅

远程访问服务 (RAS) 概述

RAS 服务器管理功能

LoadLibrary

GlobalAlloc

LoadString