[New - Windows NT]
RasAdminGetErrorString功能检索与RAS服务器管理(RasAdmin)功能之一返回的RAS错误代码相对应的消息字符串。这些消息字符串是作为RAS的一部分安装的RASMSG.DLL检索的。
DWORD RasAdminGetErrorString (
UINT 【ResourceId】, | //获取消息的错误代码 |
WCHAR *【lpszStringhu】, | //指向接收错误字符串的缓冲区的指针 |
DWORD 【InBufSize】 | //缓冲区大小(以字符为单位) |
); |
参数
【ResourceId】
指定由其中一个RasAdmin函数返回的错误代码。该值必须在RASERROR.H中定义的RASBASE到RASBASEEND的错误代码范围内。
【lpszStringhu】
指向接收与指定错误代码相对应的错误消息的缓冲区。
【InBufSize】
指定【lpszStringhu】缓冲区的大小(以字符为单位)。错误消息通常为80个字符或更少; 512个字符的缓冲区大小总是足够的。
返回值
如果函数成功,则返回值为ERROR_SUCCESS。
如果函数失败,则返回值是错误代码。该值可以是由LoadLibrary,GlobalAlloc或LoadString功能设置的最后一个错误值;或者它可以是以下错误代码之一。
值 | 含义 |
ERROR_INVALID_PARAMETER | 【ResourceId】或【lpszStringhu】参数无效。 |
ERROR_INSUFFICIENT_BUFFER | 由【InBufSize】参数指定的大小太小。 |
请勿致电GetLastError以获取此函数的错误信息。
备注
RasAdmin功能可以返回不在RasAdminGetErrorString功能支持的范围内的错误代码。例如,RasAdmin函数可以返回在LMERR.H和WINERROR.H中定义的错误代码。在调用RasAdminGetErrorString之前,请确认RASBORR.H中定义的错误代码位于RASBASE到RASBASEEND之间。
也可以看看