Función midiInGetErrorTextA (mmeapi.h)
La función midiInGetErrorText recupera una descripción textual de un error identificado por el código de error especificado.
Sintaxis
MMRESULT midiInGetErrorTextA(
MMRESULT mmrError,
LPSTR pszText,
UINT cchText
);
Parámetros
mmrError
Código de error.
pszText
Puntero al búfer que se va a rellenar con la descripción del error textual.
cchText
Longitud, en caracteres, del búfer al que apunta lpText.
Valor devuelto
Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.
| Código devuelto | Descripción |
|---|---|
|
El número de error especificado está fuera del intervalo. |
|
El puntero o la estructura especificados no son válidos. |
|
El sistema no puede asignar o bloquear la memoria. |
Comentarios
Si la descripción del error textual es mayor que el búfer especificado, la descripción se trunca. La cadena de error devuelta siempre está terminada en null. Si cchText es cero, no se copia nada y la función devuelve cero. Todas las descripciones de errores tienen menos de caracteres MAXERRORLENGTH.
Nota
El encabezado mmeapi.h define midiInGetErrorText como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mmeapi.h (incluya Windows.h) |
| Library | Winmm.lib |
| Archivo DLL | Winmm.dll |