Funzione midiOutGetErrorText (mmeapi.h)

La funzione midiOutGetErrorText recupera una descrizione testuale per un errore identificato dal codice di errore specificato.

Sintassi

MMRESULT midiOutGetErrorText(
  MMRESULT mmrError,
  LPSTR    pszText,
  UINT     cchText
);

Parametri

mmrError

Codice di errore.

pszText

Puntatore a un buffer da riempire con la descrizione dell'errore testuale.

cchText

Lunghezza, in caratteri, del buffer a cui punta lpText.

Valore restituito

Restituisce MMSYSERR_NOERROR se l'esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito Descrizione
MMSYSERR_BADERRNUM
Il numero di errore specificato non è compreso nell'intervallo.
MMSYSERR_INVALPARAM
Il puntatore o la struttura specificati non sono validi.

Commenti

Se la descrizione dell'errore testuale è più lunga del buffer specificato, la descrizione viene troncata. La stringa di errore restituita è sempre con terminazione Null. Se cchText è zero, non viene copiato nulla e la funzione restituisce MMSYSERR_NOERROR. Tutte le descrizioni degli errori sono inferiori ai caratteri MAXERRORLENGTH.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mmeapi.h (include Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Funzioni MIDI