funzione midiOutGetErrorTextA (mmeapi.h)

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

Sintassi

MMRESULT midiOutGetErrorTextA(
  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 in caso di esito positivo o di errore. I possibili valori di errore 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.

Osservazioni

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 alcun elemento e la funzione restituisce MMSYSERR_NOERROR. Tutte le descrizioni degli errori sono inferiori ai caratteri MAXERRORLENGTH.

Nota

L'intestazione mmeapi.h definisce midiOutGetErrorText come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	mmeapi.h (include Windows.h)
libreria	Winmm.lib
dll	Winmm.dll

Vedere anche

funzioni MIDI