RasGetErrorString

【勇芳软件工作室】汉化HomePreviousNext

RasGetErrorString函数获取指定RAS错误值的错误消息字符串。

DWORD RasGetErrorString(

UINT 【uErrorValue】,//获取字符串的错误
LPTSTR 【lpszErrorString】,//缓冲区保存错误字符串
DWORD 【cBufSize】//大小(以字符为单位)的缓冲区
); 

参数

【uErrorValue】

指定感兴趣的错误值。这些是由RAS函数之一返回的值:RAS头文件中列出的值。

【lpszErrorString】

指向缓冲区,该函数将写入错误字符串。此参数不能为NULL。

【cBufSize】

指定由【lpszErrorString】指向的缓冲区的大小(以字符为单位)。

返回值

如果函数成功,返回值为零。

如果函数失败,返回值是非零的错误值。该值为ERROR_INVALID_PARAMETER或从函数GlobalAllocLoadString返回的GetLastError值。该函数没有设置线程的最后一个错误信息;也就是说,没有RasGetErrorString功能设置的GetLastError信息。

备注

没有办法提前确定错误消息的字符的确切大小,从而确定所需的缓冲区的大小。错误消息的大小一般为80个字符以内; 256个字符的缓冲区大小将始终是足够的。大小不足的缓冲区导致RasGetErrorString功能失败,返回ERROR_INSUFFICIENT_BUFFER。请注意,缓冲区大小以字符指定,而不是字节;因此,Unicode版本的RasGetErrorString需要一个512字节的缓冲区来保证每个错误消息都适合。

也可以看看

GlobalAlloc, LoadString