Função CharLowerWrapW

[CharLowerWrapW está disponível para uso no Windows XP. Ele pode não estar disponível em versões subsequentes. Você deve usar CharLowerW em seu lugar.]

Converte uma cadeia de caracteres Unicode ou um único caractere em minúsculas. Se o operando for uma cadeia de caracteres, a função converterá os caracteres no local.

Sintaxe

LPWSTR CharLowerWrapW(
  _Inout_ LPWSTR pch
);

Parâmetros

pch [in, out]

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo ou um único caractere. Se a palavra de alta ordem desse parâmetro for zero, a palavra de ordem baixa deverá conter apenas um único caractere a ser convertido.

Valor retornado

Tipo: LPWSTR

Se pch for uma cadeia de caracteres, a função retornará um ponteiro para a cadeia de caracteres convertida. Como a cadeia de caracteres é convertida no local, o valor retornado é igual a pch.

Se pch for um único caractere, o valor retornado será um valor de 32 bits cuja palavra de ordem alta é zero e a palavra de ordem baixa conterá o caractere convertido.

Não há indicação de êxito ou falha. Falha é rara. Não há informações de erro estendidas para essa função; não chame GetLastError.

Comentários

O método preferencial é usar CharLowerW em conjunto com a MSLU (Microsoft Layer for Unicode).

CharLowerWrapW deve ser chamado diretamente de Shlwapi.dll, usando o ordinal 38.

Requisitos

Confira também

CharLower