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。
如果函数失败,则返回值为错误代码。 此值可以是 LoadLibrary、 GlobalAlloc 或 LoadString 函数设置的最后一个错误值;也可以是以下错误代码之一。
值 | 含义 |
---|---|
|
ResourceId 或 lpszString 参数无效。 |
|
InBufSize 参数指定的大小太小。 |
此函数没有扩展的错误信息;不要调用 GetLastError。
备注
RasAdmin 函数可以返回不在 RasAdminGetErrorString 函数支持的范围内的错误代码。 例如,RasAdmin 函数可以返回 Lmerr.h 和 Winerror.h 中定义的错误代码。 在调用 RasAdminGetErrorString 之前,请验证错误代码是否在 Raserror.h 中定义的 RASBASE 到 RASBASEEND 的范围内。
要求
要求 | 值 |
---|---|
客户端支持终止 |
Windows 2000 Professional |
终止服务器支持 |
Windows 2000 Server |
标头 |
|
库 |
|
DLL |
|