funzione midiInGetErrorTextW (mmeapi.h)
La funzione midiInGetErrorText recupera una descrizione testuale per un errore identificato dal codice di errore specificato.
Sintassi
MMRESULT midiInGetErrorTextW(
MMRESULT mmrError,
LPWSTR pszText,
UINT cchText
);
Parametri
mmrError
Codice di errore.
pszText
Puntatore al 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 ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.
Codice restituito | Descrizione |
---|---|
|
Il numero di errore specificato non è compreso nell'intervallo. |
|
Il puntatore o la struttura specificati non è valido. |
|
Il sistema non è in grado di allocare o bloccare la memoria. |
Commenti
Se la descrizione dell'errore testuale è più lunga del buffer specificato, la descrizione viene troncata. La stringa di errore restituita viene sempre terminata con valore Null. Se cchText è zero, non viene copiato nulla e la funzione restituisce zero. Tutte le descrizioni degli errori sono inferiori ai caratteri MAXERRORLENGTH lunghi.
Nota
L'intestazione mmeapi.h definisce midiInGetErrorText come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 (includere Windows.h) |
Libreria | Winmm.lib |
DLL | Winmm.dll |