Ponteiro para o buffer de entrada a ser examinado.
[in] iSize
Tamanho, em bytes, do buffer de entrada indicado pelo lpv.
[in, out, optional] lpiResult
Na entrada, ponteiro para os testes a serem aplicados ao texto do buffer de entrada. Na saída, esse parâmetro recebe os resultados dos testes especificados: 1 se o conteúdo do buffer passar em um teste, 0 para falha. Somente os sinalizadores que são definidos na entrada para a função são significativos na saída.
Se lpiResult for NULL, a função usará todos os testes disponíveis para determinar se os dados no buffer provavelmente serão texto Unicode.
Esse parâmetro pode usar um dos valores a seguir. Os valores podem ser combinados com "OR" binário.
Valor
Significado
IS_TEXT_UNICODE_ASCII16
O texto é Unicode e contém apenas valores/caracteres ASCII estendidos por zero.
IS_TEXT_UNICODE_REVERSE_ASCII16
Igual ao anterior, exceto que o texto Unicode é invertido por bytes.
IS_TEXT_UNICODE_STATISTICS
O texto provavelmente é Unicode, com a determinação feita pela aplicação da análise estatística. A certeza absoluta não é garantida. Consulte a seção Comentários.
IS_TEXT_UNICODE_REVERSE_STATISTICS
Igual ao anterior, exceto que o texto que provavelmente é Unicode está invertido por bytes.
IS_TEXT_UNICODE_CONTROLS
O texto contém representações Unicode de um ou mais desses caracteres não imprimíveis: RETURN, LINEFEED, SPACE, CJK_SPACE, TAB.
IS_TEXT_UNICODE_REVERSE_CONTROLS
Igual ao anterior, exceto que os caracteres Unicode são invertidos por bytes.
IS_TEXT_UNICODE_BUFFER_TOO_SMALL
Há poucos caracteres no buffer para análise significativa (menos de dois bytes).
IS_TEXT_UNICODE_SIGNATURE
O texto contém a marca de ordem de bytes Unicode (BOM) 0xFEFF como seu primeiro caractere.
IS_TEXT_UNICODE_REVERSE_SIGNATURE
O texto contém a marca de ordem de byte invertida por bytes Unicode (BOM Inversa) 0xFFFE como seu primeiro caractere.
IS_TEXT_UNICODE_ILLEGAL_CHARS
O texto contém um desses caracteres Unicode-illegal: BOM Reverso incorporado, UNICODE_NUL, CRLF (empacotado em uma palavra) ou 0xFFFF.
IS_TEXT_UNICODE_ODD_LENGTH
O número de caracteres na cadeia de caracteres é estranho. Uma cadeia de caracteres de comprimento ímpar não pode (por definição) ser texto Unicode.
IS_TEXT_UNICODE_NULL_BYTES
O texto contém bytes nulos, que indicam texto não ASCII.
IS_TEXT_UNICODE_UNICODE_MASK
O valor é uma combinação de IS_TEXT_UNICODE_ASCII16, IS_TEXT_UNICODE_STATISTICS, IS_TEXT_UNICODE_CONTROLS IS_TEXT_UNICODE_SIGNATURE.
IS_TEXT_UNICODE_REVERSE_MASK
O valor é uma combinação de IS_TEXT_UNICODE_REVERSE_ASCII16, IS_TEXT_UNICODE_REVERSE_STATISTICS, IS_TEXT_UNICODE_REVERSE_CONTROLS IS_TEXT_UNICODE_REVERSE_SIGNATURE.
IS_TEXT_UNICODE_NOT_UNICODE_MASK
O valor é uma combinação de IS_TEXT_UNICODE_ILLEGAL_CHARS, IS_TEXT_UNICODE_ODD_LENGTH e dois sinalizadores de bits não utilizados no momento.
IS_TEXT_UNICODE_NOT_ASCII_MASK
O valor é uma combinação de IS_TEXT_UNICODE_NULL_BYTES e três sinalizadores de bits não utilizados no momento.
Retornar valor
Retorna um valor diferente de zero se os dados no buffer passarem nos testes especificados. A função retornará 0 se os dados no buffer não passarem nos testes especificados.
Comentários
Essa função usa vários métodos estatísticos e determinísticos para fazer sua determinação, sob o controle de sinalizadores passados no parâmetro lpiResult . Quando a função retorna, os resultados desses testes são relatados usando o mesmo parâmetro.
Os testes de IS_TEXT_UNICODE_STATISTICS e IS_TEXT_UNICODE_REVERSE_STATISTICS usam análise estatística. Esses testes não são à prova de falhas. Os testes estatísticos pressupõem determinadas quantidades de variação entre bytes baixos e altos em uma cadeia de caracteres, e algumas cadeias de caracteres ASCII podem passar. Por exemplo, se lpv indicar a cadeia de caracteres ASCII 0x41, 0x0A, 0x0D, 0x1D (A\n\r^Z), a cadeia de caracteres passará no teste de IS_TEXT_UNICODE_STATISTICS, embora a falha seja preferível.
Requisitos
Requisito
Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]