Foutberichten ophalen

Wanneer een methodeaanroep een fout produceert, retourneren veel functies een foutcode. Voor de meeste Certificate Services-interfaces en API-elementen die een foutcode retourneren, kan de tekst van het foutbericht worden opgehaald door FormatMessage- aan te roepen met een NULL- modulehandgreep. Als FormatMessage- niet slaagt, is de foutcode waarschijnlijk het gevolg van een back-up-API-element of databasefout; als u FormatMessage aanroept met een modulegreep die overeenkomt met de Ntdsbmsg.dll-bibliotheek, moet de tekst van het foutbericht worden opgehaald. In het volgende voorbeeld ziet u hoe u de tekst van een foutbericht in een Certificate Services-toepassing ophaalt.

#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." );

}