Compartilhar via

Função midiInGetErrorTextW (mmeapi.h)

  • Artigo

A função midiInGetErrorText recupera uma descrição textual de um erro identificado pelo código de erro especificado.

Sintaxe

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

Parâmetros

mmrError

Código de erro.

pszText

Ponteiro para o buffer a ser preenchido com a descrição do erro textual.

cchText

Comprimento, em caracteres, do buffer apontado por lpText.

Valor de retorno

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
MMSYSERR_BADERRNUM
 O número de erro especificado está fora do intervalo.
MMSYSERR_INVALPARAM
 O ponteiro ou estrutura especificado é inválido.
MMSYSERR_NOMEM
 O sistema não pode alocar ou bloquear memória.

Observações

Se a descrição do erro textual for maior que o buffer especificado, a descrição será truncada. A cadeia de caracteres de erro retornada é sempre terminada em nulo. Se cchText for zero, nada será copiado e a função retornará zero. Todas as descrições de erro são menores do que os caracteres MAXERRORLENGTH.

Nota

O cabeçalho mmeapi.h define midiInGetErrorText como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho mmeapi.h (inclua Windows.h)
biblioteca Winmm.lib
de DLL Winmm.dll

Consulte também

Funções MIDI