Compartilhar via


ATLENSURE

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

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

Parâmetros

  • booleanExpression
    Especifica uma expressão booleana a ser testada.

  • hr
    Especifica um código de erro para retornar.

Comentários

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

Consulte também

Referência

ATLASSERT

GARANTIR (MFC)

Outros recursos

Macros de depuração e relatório de erros

Macros de ATL