Поиск текста для номеров кодов ошибок
Иногда необходимо отобразить текст ошибки, связанный с кодами ошибок, возвращаемыми функциями, связанными с сетью. Возможно, вам потребуется выполнить эту задачу с помощью функций управления сетью, предоставляемых системой.
Текст ошибки для этих сообщений находится в файле таблицы сообщений с именем Netmsg.dll, который находится в папке %systemroot%\system32. Этот файл содержит сообщения об ошибках в диапазоне от NERR_BASE (2100) до MAX_NERR(NERR_BASE+899). Эти коды ошибок определяются в файле заголовка пакета SDK lmerr.h.
Функции LoadLibrary и LoadLibraryEx могут загружать Netmsg.dll. Функция FormatMessage сопоставляет код ошибки с текстом сообщения, при этом дескриптор модуля соответствует файлу Netmsg.dll.
В следующем примере показано, как отобразить текст ошибки, связанный с функциями управления сетью, в дополнение к тексту ошибки, связанному с системными кодами ошибок. Если указанный номер ошибки находится в определенном диапазоне, netmsg.dll модуль сообщений загружается и используется для поиска указанного номера ошибки с помощью функции FormatMessage .
#include <windows.h>
#include <stdio.h>
#include <lmerr.h>
void
DisplayErrorText(
DWORD dwLastError
);
#define RTN_OK 0
#define RTN_USAGE 1
#define RTN_ERROR 13
int
__cdecl
main(
int argc,
char *argv[]
)
{
if(argc != 2) {
fprintf(stderr,"Usage: %s <error number>\n", argv[0]);
return RTN_USAGE;
}
DisplayErrorText( atoi(argv[1]) );
return RTN_OK;
}
void
DisplayErrorText(
DWORD dwLastError
)
{
HMODULE hModule = NULL; // default to system source
LPSTR MessageBuffer;
DWORD dwBufferLength;
DWORD dwFormatFlags = FORMAT_MESSAGE_ALLOCATE_BUFFER |
FORMAT_MESSAGE_IGNORE_INSERTS |
FORMAT_MESSAGE_FROM_SYSTEM ;
//
// If dwLastError is in the network range,
// load the message source.
//
if(dwLastError >= NERR_BASE && dwLastError <= MAX_NERR) {
hModule = LoadLibraryEx(
TEXT("netmsg.dll"),
NULL,
LOAD_LIBRARY_AS_DATAFILE
);
if(hModule != NULL)
dwFormatFlags |= FORMAT_MESSAGE_FROM_HMODULE;
}
//
// Call FormatMessage() to allow for message
// text to be acquired from the system
// or from the supplied module handle.
//
if(dwBufferLength = FormatMessageA(
dwFormatFlags,
hModule, // module to get message from (NULL == system)
dwLastError,
MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT), // default language
(LPSTR) &MessageBuffer,
0,
NULL
))
{
DWORD dwBytesWritten;
//
// Output message string on stderr.
//
WriteFile(
GetStdHandle(STD_ERROR_HANDLE),
MessageBuffer,
dwBufferLength,
&dwBytesWritten,
NULL
);
//
// Free the buffer allocated by the system.
//
LocalFree(MessageBuffer);
}
//
// If we loaded a message source, unload it.
//
if(hModule != NULL)
FreeLibrary(hModule);
}
После компиляции этой программы можно вставить номер кода ошибки в качестве аргумента, и программа отобразит текст. Пример:
C:\> netmsg 2453
Could not find domain controller for this domain