Behandeln von MCI-Fehlern

[Das dieser Seite zugeordnete Feature MCI ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von MCI zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Sie sollten immer den Rückgabewert der mciSendCommand-Funktion überprüfen. Wenn ein Fehler angezeigt wird, können Sie mciGetErrorString verwenden, um eine Textbeschreibung des Fehlers abzurufen.

Im folgenden Beispiel wird der von dwError angegebene MCI-Fehlercode an mciGetErrorString übergeben und dann die resultierende Textfehlerbeschreibung mithilfe der MessageBox-Funktion angezeigt.

// Use mciGetErrorString to get a textual description of an MCI error.
// Display the error description using MessageBox.

void showError(DWORD dwError)
{
    char szErrorBuf[MAXERRORLENGTH];
    MessageBeep(MB_ICONEXCLAMATION);
    if(mciGetErrorString(dwError, (LPSTR) szErrorBuf, MAXERRORLENGTH))
    {
        MessageBox(hMainWnd, szErrorBuf, "MCI Error",
        MB_ICONEXCLAMATION);
    }
    else
    {
        MessageBox(hMainWnd, "Unknown Error", "MCI Error",
            MB_ICONEXCLAMATION);
    }
}
 

Hinweis

Um einen mciSendCommand-Fehlerrückgabewert selbst zu interpretieren, maskieren Sie das Wort mit hoher Reihenfolge (das Wort mit niedriger Reihenfolge enthält den Fehlercode). Wenn Sie den Fehlerrückgabewert jedoch an mciGetErrorString übergeben, müssen Sie den gesamten Doubleword-Wert übergeben.