Compartilhar via


Função SetProcessDynamicEnforcedCetCompatibleRanges (processthreadsapi.h)

Observação

Essa API foi adicionada ao SDK de 19041 em uma atualização lançada em novembro de 2020.

Define intervalos CETCOMPAT imposto dinâmicos para o processo especificado.

Sintaxe

BOOL SetProcessDynamicEnforcedCetCompatibleRanges(
  HANDLE                                  Process,
  USHORT                                  NumberOfRanges,
  PPROCESS_DYNAMIC_ENFORCED_ADDRESS_RANGE Ranges
);

Parâmetros

Process

Um identificador para o processo. Esse identificador deve ter o acesso PROCESS_SET_INFORMATION correto. Para obter mais informações, consulte Direitos de Acesso e Segurança do Processo.

NumberOfRanges

Fornece o número de intervalos CETCOMPAT imposto dinâmicos a serem definidos.

Ranges

Um ponteiro para uma matriz de intervalos CETCOMPAT imposto dinâmicos. Para obter mais informações sobre essa estrutura, consulte PROCESS_DYNAMIC_ENFORCED_ADDRESS_RANGE.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Observe que, mesmo que a função falhe, uma parte dos intervalos CETCOMPAT fornecidos pode ter sido processada com êxito. O chamador precisa marcar os sinalizadores em cada intervalo CETCOMPAT individual especificado por meio de Intervalos para determinar se ele foi processado com êxito.

Comentários

O HSP (Proteção contra Pilha imposta por hardware) no modo de usuário é um recurso de segurança em que a CPU verifica os endereços de retorno da função em runtime empregando um mecanismo de pilha de sombra, se houver suporte do hardware. No modo de compatibilidade do HSP, somente as violações de pilha de sombra que ocorrem em módulos considerados compatíveis com pilhas de sombra (CETCOMPAT) são fatais. Para que um módulo seja considerado CETCOMPAT, ele precisa ser compilado com CETCOMPAT para binários ou marcado usando SetProcessDynamicEnforcedCetCompatibleRanges para código dinâmico. No modo estrito do HSP, todas as violações de pilha de sombra são fatais.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 2004 (10.0; Build 19041.662)
Servidor mínimo com suporte Windows Server, versão 2004 (10.0; Build 19041.662)
Cabeçalho processthreadsapi.h