ATLENSURE
Questa macro viene utilizzata per convalidare i parametri passati a una funzione.
ATLENSURE(booleanExpression);
ATLENSURE_THROW(booleanExpression, hr);
Parametri
booleanExpression
Specifica un'espressione booleana da testare.hr
Specifica un codice di errore per restituire.
Note
Queste macro forniscono un meccanismo per rilevare e informare l'utente di utilizzo errato di parametri.
Le macro chiamate ATLASSERT e se la condizione non riesce le chiamate AtlThrow.
Nel caso ATLENSURE, AtlThrow viene chiamato con E_FAIL.
Nel caso ATLENSURE_THROW, AtlThrow viene chiamato con HRESULT specificato.
La differenza tra ATLENSURE e ATLASSERT è che ATLENSURE genera un'eccezione nelle build di rilascio nonché nelle build di debug.
Esempio
void MyImportantFunction(char* psz)
{
ATLENSURE(NULL != psz);
char mysz[64];
strcpy_s(mysz, sizeof(mysz), psz);
}
Requisiti
Header: afx.h