Função IsBadStringPtrA (winbase.h)
Verifica se o processo de chamada tem acesso de leitura ao intervalo de memória especificado.
Sintaxe
BOOL IsBadStringPtrA(
[in] LPCSTR lpsz,
[in] UINT_PTR ucchMax
);
Parâmetros
[in] lpsz
Um ponteiro para uma cadeia de caracteres terminada em nulo, Unicode ou ASCII.
[in] ucchMax
O tamanho máximo da cadeia de caracteres, em TCHARs. A função verifica o acesso de leitura em todos os caracteres até o caractere nulo de terminação da cadeia de caracteres ou até o número de caracteres especificado por esse parâmetro, o que for menor. Se esse parâmetro for zero, o valor retornado será zero.
Retornar valor
Se o processo de chamada tiver acesso de leitura a todos os caracteres até o caractere nulo de terminação da cadeia de caracteres ou até o número de caracteres especificado por ucchMax, o valor retornado será zero.
Se o processo de chamada não tiver acesso de leitura a todos os caracteres até o caractere nulo de terminação da cadeia de caracteres ou até o número de caracteres especificado por ucchMax, o valor retornado será diferente de zero.
Se o aplicativo for compilado como uma versão de depuração e o processo não tiver acesso de leitura a todo o intervalo de memória especificado, a função causará uma asserção e entrará no depurador. Saindo do depurador, a função continua como de costume e retorna um valor diferente de zero Esse comportamento é por design, como um auxílio de depuração.
Comentários
Normalmente, essa função é usada ao trabalhar com ponteiros retornados de bibliotecas de terceiros, em que você não pode determinar o comportamento de gerenciamento de memória na DLL de terceiros.
Espera-se que os threads em um processo cooperem de forma que um não libere a memória de que o outro precisa. O uso dessa função não nega a necessidade de fazer isso. Se isso não for feito, o aplicativo poderá falhar de maneira imprevisível.
Desreferenciar ponteiros potencialmente inválidos pode desabilitar a expansão da pilha em outros threads. Um thread esgotando sua pilha, quando a expansão da pilha foi desabilitada, resulta no encerramento imediato do processo pai, sem nenhuma janela de erro pop-up ou informações de diagnóstico.
Se o processo de chamada tiver acesso de leitura a alguns, mas não a todos, do intervalo de memória especificado, o valor retornado não será zero.
Em um ambiente de multitarefa preemptiva, é possível que algum outro thread altere o acesso do processo à memória que está sendo testada. Mesmo quando a função indica que o processo tem acesso de leitura à memória especificada, você deve usar o tratamento de exceção estruturado ao tentar acessar a memória. O uso do tratamento de exceção estruturado permite que o sistema notifique o processo se ocorrer uma exceção de violação de acesso, dando ao processo a oportunidade de lidar com a exceção.
Observação
O cabeçalho winbase.h define IsBadStringPtr como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |