__crtLCMapStringW

Mapeia uma seqüência de caracteres para outro, realizando uma transformação de depende da localidade especificada.Esta função também pode ser usada para gerar uma chave de classificação para a seqüência de entrada.

int __crtLCMapStringW(
   LCID    Locale,
   DWORD   dwMapFlags,
   LPCWSTR lpSrcStr,
   int     cchSrc,
   LPWSTR  lpDestStr,
   int     cchDest)

Parâmetros

• Locale
  Identificador de localidade.A localidade fornece um contexto para o mapeamento de seqüência de caracteres ou a geração de chaves de classificação.Um aplicativo pode usar o MAKELCID macro para criar um identificador de localidade.

• dwMapFlags
  O tipo de transformação a ser usado durante a geração de chave mapeamento ou classificar cadeia de caracteres.

• lpSrcStr
  Ponteiro para uma seqüência de caracteres de origem que a função mapeia ou usa para geração de chaves de classificação.Esse parâmetro será considerado uma seqüência de caracteres Unicode.

• cchSrc
  O tamanho, em caracteres, da seqüência de caracteres apontada pela lpSrcStr parâmetro.Essa contagem pode incluir o terminador nulo ou não incluí-lo.

  A cchSrc valor – 1 Especifica que a seqüência de caracteres apontada por lpSrcStr é terminada por caractere nulo.Se for esse o caso, e essa função está sendo usada em seu modo de mapeamento de seqüência de caracteres, a função calcula o comprimento da seqüência de caracteres propriamente dito e null-Finaliza a seqüência de caracteres mapeada armazenada em *lpDestStr.

• lpDestStr
  Ponteiro longo para um buffer no qual a função armazena a chave de seqüência de caracteres ou classificação mapeada.

• cchDest
  O tamanho, em caracteres, do buffer apontada por lpDestStr.

Valor de retorno

Se o valor de cchDest é diferente de zero, o número de caracteres ou bytes se LCMAP_SORTKEY é especificado, escrito para o buffer indica êxito.Essa contagem inclui espaço para um terminador nulo.

Se o valor de cchDest é zero, o tamanho do buffer em caracteres ou bytes, se LCMAP_SORTKEY for especificado, necessário para receber o traduzido chave de seqüência de caracteres ou classificação indica sucesso.Esse tamanho inclui o espaço para um terminador nulo.

Zero indica falha.Para obter mais informações sobre o erro, chame o GetLastError função.

Comentários

Se cchSrc for maior que zero e lpSrcStr é uma seqüência terminada por caractere nulo, __crtLCMapStringW define cchSrc para o comprimento da seqüência de caracteres.Em seguida, __crtLCMapStringW chama a versão de cadeia de caracteres larga (Unicode) da LCMapString função com os parâmetros especificados.Para obter mais informações sobre os parâmetros e o valor de retorno dessa função, consulte a LCMapString funcionar no MSDN Library.

Requisitos