Получение сообщений об ошибках
Когда вызов метода вызывает ошибку, многие функции возвращают код ошибки. Для большинства интерфейсов служб сертификатов и элементов API, возвращающих код ошибки, текст сообщения об ошибке можно получить, вызвав FormatMessage с дескриптором модуля NULL . Если FormatMessage не выполняется, код ошибки, скорее всего, является результатом резервного элемента API или ошибки, связанной с базой данных; Вызов FormatMessage с дескриптором модуля, соответствующим библиотеке Ntdsbmsg.dll, должен получить текст сообщения об ошибке. В следующем примере показано, как получить текст сообщения об ошибке в приложении служб сертификатов.
#include <windows.h>
#include <stdio.h>
// Display error message text, given an error code.
// Typically, the parameter passed to this function is retrieved
// from GetLastError().
void PrintCSBackupAPIErrorMessage(DWORD dwErr)
{
WCHAR wszMsgBuff[512]; // Buffer for text.
DWORD dwChars; // Number of chars returned.
// Try to get the message from the system errors.
dwChars = FormatMessage( FORMAT_MESSAGE_FROM_SYSTEM |
FORMAT_MESSAGE_IGNORE_INSERTS,
NULL,
dwErr,
0,
wszMsgBuff,
512,
NULL );
if (0 == dwChars)
{
// The error code did not exist in the system errors.
// Try Ntdsbmsg.dll for the error code.
HINSTANCE hInst;
// Load the library.
hInst = LoadLibrary(L"Ntdsbmsg.dll");
if ( NULL == hInst )
{
printf("cannot load Ntdsbmsg.dll\n");
exit(1); // Could 'return' instead of 'exit'.
}
// Try getting message text from ntdsbmsg.
dwChars = FormatMessage( FORMAT_MESSAGE_FROM_HMODULE |
FORMAT_MESSAGE_IGNORE_INSERTS,
hInst,
dwErr,
0,
wszMsgBuff,
512,
NULL );
// Free the library.
FreeLibrary( hInst );
}
// Display the error message, or generic text if not found.
printf("Error value: %d Message: %ws\n",
dwErr,
dwChars ? wszMsgBuff : L"Error message not found." );
}