Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

ATLENSURE

 

Este macro é usado para validar os parâmetros passados para uma função.


      ATLENSURE(
      booleanExpression
      );
ATLENSURE_THROW(booleanExpression, hr);

booleanExpression

Especifica uma expressão booleana a ser testada.

hr

Especifica um código de erro para retornar.

Esses macros fornecem um mecanismo para detectar e notificar o usuário de uso incorreto de parâmetro.

Chamadas macro ATLASSERT e se a condição falha chamadas AtlThrow.

Em os exemplos de ATLENSURE , AtlThrow é chamado com E_FAIL.

Em os exemplos de ATLENSURE_THROW , AtlThrow é chamado com o HRESULT especificado.

A diferença entre ATLENSURE e ATLASSERT é que ATLENSURE lança uma exceção nas compilações lançadas assim como em compilações de depuração.

Exemplo

void MyImportantFunction(char* psz)
{
   ATLENSURE(NULL != psz);

   char mysz[64];
   strcpy_s(mysz, sizeof(mysz), psz);
}

Requisitos

Cabeçalho: afx.h

Mostrar: