_set_invalid_parameter_handler, _set_thread_local_invalid_parameter_handler

Imposta una funzione da chiamare quando CRT rileva un argomento non valido.

Sintassi

_invalid_parameter_handler _set_invalid_parameter_handler(
   _invalid_parameter_handler pNew
);
_invalid_parameter_handler _set_thread_local_invalid_parameter_handler(
   _invalid_parameter_handler pNew
);

Parametri

pNew
Il puntatore a funzione al nuovo gestore di parametro non valido.

Valore restituito

Un puntatore al gestore di parametro non valido prima della chiamata.

Osservazioni:

Molte funzioni di runtime C verificano la validità degli argomenti passati. Se un argomento non valido viene passato, la funzione può impostare il numero di errore errno o restituire un codice di errore. In tali casi, viene chiamato anche il gestore di parametro non valido. Il runtime C include un gestore di parametri non validi globale predefinito che termina il programma e visualizza un messaggio di errore di runtime. È possibile usare _set_invalid_parameter_handler per impostare una funzione come gestore di parametri non validi globale. Il runtime C supporta anche un gestore di parametri non validi thread-local. Se viene impostato un gestore di parametri non validi thread-local in un thread usando _set_thread_local_invalid_parameter_handler, le funzioni di runtime C chiamate dal thread usano tale gestore invece del gestore globale. Solo una funzione per volta può essere specificata come gestore di argomenti non validi globale. È possibile specificare una sola funzione come gestore di argomenti non validi thread-local per ogni thread, ma thread diversi possono avere gestori thread-local differenti. I gestori locali del thread consentono di modificare il gestore usato in una parte del codice senza influire sul comportamento di altri thread.

Quando il runtime chiama la funzione di gestione dei parametri non validi, in genere significa che si è verificato un errore irreversibile. La funzione di gestione dei parametri non validi specificata deve salvare tutti i dati possibili e quindi verrà interrotta. Non deve restituire il controllo alla funzione principale, a meno che non si sia certi che l'errore sia recuperabile.

La funzione del gestione di parametro non valido deve avere il seguente prototipo:

void _invalid_parameter(
   const wchar_t * expression,
   const wchar_t * function,
   const wchar_t * file,
   unsigned int line,
   uintptr_t pReserved
);

L'argomento expression è una rappresentazione di stringa di caratteri wide dell'espressione argomento che ha generato l'errore. L'argomento function è il nome della funzione CRT che ha ricevuto l'argomento non valido. L'argomento file è il nome del file di origine CRT che contiene la funzione. L'argomento line è il numero di riga in tale file. L'ultimo argomento è riservato. I parametri hanno tutti il valore NULL a meno che una versione di debug della libreria CRT non venga utilizzata.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo	Intestazione obbligatoria
_set_invalid_parameter_handler, _set_thread_local_invalid_parameter_handler	C: <stdlib.h> C++: <cstdlib> o <stdlib.h>

Le _set_invalid_parameter_handler funzioni e _set_thread_local_invalid_parameter_handler sono specifiche di Microsoft. Per informazioni sulla compatibilità, vedere Compatibilità.

Esempio

Nell'esempio seguente, un gestore errori di parametro non valido viene utilizzato per stampare la funzione che ha ricevuto il parametro non valido e il file e la riga nelle origini CRT. Quando viene usata la libreria CRT di debug, anche gli errori di parametro non validi generano un'asserzione, disabilitata in questo esempio usando _CrtSetReportMode.

// crt_set_invalid_parameter_handler.c
// compile with: /Zi /MTd
#include <stdio.h>
#include <stdlib.h>
#include <crtdbg.h>  // For _CrtSetReportMode

void myInvalidParameterHandler(const wchar_t* expression,
   const wchar_t* function,
   const wchar_t* file,
   unsigned int line,
   uintptr_t pReserved)
{
   wprintf(L"Invalid parameter detected in function %s."
            L" File: %s Line: %d\n", function, file, line);
   wprintf(L"Expression: %s\n", expression);
   abort();
}

int main( )
{
   char* formatString;

   _invalid_parameter_handler oldHandler, newHandler;
   newHandler = myInvalidParameterHandler;
   oldHandler = _set_invalid_parameter_handler(newHandler);

   // Disable the message box for assertions.
   _CrtSetReportMode(_CRT_ASSERT, 0);

   // Call printf_s with invalid parameters.

   formatString = NULL;
   printf(formatString);
}

Invalid parameter detected in function common_vfprintf. File: minkernel\crts\ucrt\src\appcrt\stdio\output.cpp Line: 32
Expression: format != nullptr

Vedi anche

_get_invalid_parameter_handler, _get_thread_local_invalid_parameter_handler
Versioni avanzate della sicurezza delle funzioni CRT
errno, _doserrno, _sys_errlist e _sys_nerr