midiOutGetErrorTextA-Funktion (mmeapi.h)
Die midiOutGetErrorText--Funktion ruft eine Textbeschreibung für einen fehler ab, der durch den angegebenen Fehlercode identifiziert wird.
Syntax
MMRESULT midiOutGetErrorTextA(
MMRESULT mmrError,
LPSTR pszText,
UINT cchText
);
Parameter
mmrError
Fehlercode.
pszText
Zeiger auf einen Puffer, der mit der Textfehlerbeschreibung gefüllt werden soll.
cchText
Länge des Puffers in Zeichen, auf den durch lpText-verwiesen wird.
Rückgabewert
Gibt MMSYSERR_NOERROR zurück, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Die angegebene Fehlernummer liegt außerhalb des zulässigen Bereichs. |
|
Der angegebene Zeiger oder die angegebene Struktur ist ungültig. |
Bemerkungen
Wenn die Beschreibung des Textfehlers länger als der angegebene Puffer ist, wird die Beschreibung abgeschnitten. Die zurückgegebene Fehlerzeichenfolge ist immer null-beendet. Wenn cchText- null ist, wird nichts kopiert, und die Funktion gibt MMSYSERR_NOERROR zurück. Alle Fehlerbeschreibungen sind kleiner als MAXERRORLENGTH Zeichen lang.
Anmerkung
Der mmeapi.h-Header definiert midiOutGetErrorText als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | mmeapi.h (enthalten Windows.h) |
| Library | Winmm.lib |
| DLL- | Winmm.dll |