Share via

Función midiOutGetErrorTextW (mmeapi.h)

  • Artículo

La función midiOutGetErrorText recupera una descripción textual de un error identificado por el código de error especificado.

Sintaxis

MMRESULT midiOutGetErrorTextW(
  MMRESULT mmrError,
  LPWSTR   pszText,
  UINT     cchText
);

Parámetros

mmrError

Código de error.

pszText

Puntero a un 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 ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.

Código devuelto Descripción
MMSYSERR_BADERRNUM
 El número de error especificado está fuera del intervalo.
MMSYSERR_INVALPARAM
 El puntero o la estructura especificados no son válidos.

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 termina en null. Si cchText es cero, no se copia nada y la función devuelve MMSYSERR_NOERROR. Todas las descripciones de errores tienen menos de caracteres MAXERRORLENGTH.

Nota:

El encabezado mmeapi.h define midiOutGetErrorText 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
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 (incluye Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Funciones MIDI