На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

RasGetErrorString



The RasGetErrorString function obtains an error message string for a specified RAS error value.

DWORD RasGetErrorString (

UINT uErrorValue, // error to get string for
LPTSTR lpszErrorString, // buffer to hold error string
DWORD cBufSize // size, in characters, of buffer
);


Parameters

uErrorValue

Specifies the error value of interest. These are values returned by one of the RAS functions: those listed in the RAS header file.

lpszErrorString

Points to a buffer that the function will write the error string to. This parameter must not be NULL.

cBufSize

Specifies the size, in characters, of the buffer pointed to by lpszErrorString.



Return Values

If the function succeeds, the return value is zero.
If the function fails, the return value is a nonzero error value. This value is ERROR_INVALID_PARAMETER or the GetLastError value returned from the functions GlobalAlloc or LoadString. The function does not set a thread's last error information; that is, there is no GetLastError information set by the RasGetErrorString function.

Remarks

There is no way to determine in advance the exact size in characters of an error message, and thus the size of buffer required. Error messages will generally be 80 characters or fewer in size; a buffer size of 256 characters will always be adequate. A buffer of insufficient size causes the RasGetErrorString function to fail, returning ERROR_INSUFFICIENT_BUFFER. Note that buffer sizes are specified in characters, not bytes; thus, the Unicode version of RasGetErrorString requires a 512 byte buffer to guarantee that every error message will fit.

See Also

GlobalAlloc, LoadString


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RasGetErrorString



Функция RasGetErrorString получает строку сообщения ошибки для определенной величины ошибки RAS.

DWORD RasGetErrorString (

UINT uErrorValue, // ОШИБКА, чтобы получать строке для lpszErrorString LPTSTR, // буфера, чтобы держать строку ошибки DWORD cBufSize // размер, в символах, буфера
);


Параметры

uErrorValue

Определяет величину ошибки интереса. Эти - величины возвращанные одной из функций RAS: те указывались в файле заголовка RAS.

lpszErrorString

Точки на буфер, что функция напишет строку ошибки, чтобы. Этот параметр не должен быть НЕДЕЙСТВИТЕЛЕН.

cBufSize

Определяет размер, в символах, буфера указанного, чтобы lpszErrorString.



Обратные Величины

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

Замечания

Нет пути определяться заранее точный размер в типах сообщения ошибки, и таким образом размер буфера требовался. Сообщения Ошибки обычно будут 80 символов или меньших по величине; буферный размер 256 символов всегда будет требуемым. Буфер недостаточного размера заставляет функцию RasGetErrorString, чтобы терпеть неудачу, возврат ERROR_INSUFFICIENT_BUFFER. Отметьте, что буферные размеры определены в символах, не байтах; таким образом, версия Уникода RasGetErrorString требует 512 байтовых буферов, чтобы гарантировать, что каждое сообщение ошибки установит.

Смотри Также

GlobalAlloc, LoadString


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz