_CrtMemCheckpoint

Uzyskuje bieżący stan sterta debugowania i przechowuje je w strukturze dostarczonej _CrtMemState przez aplikację (tylko wersja debugowania).

Składnia

void _CrtMemCheckpoint(
   _CrtMemState *state
);

Parametry

state
Wskaźnik do _CrtMemState struktury do wypełnienia punktem kontrolnym pamięci.

Uwagi

Funkcja _CrtMemCheckpoint tworzy migawkę bieżącego stanu sterta debugowania w danym momencie. Ta migawka może być używana przez inne funkcje stanu stert, takie jak _CrtMemDifference w celu wykrywania przecieków pamięci i innych problemów. Gdy _DEBUG nie jest zdefiniowana, wywołania do _CrtMemState są usuwane podczas przetwarzania wstępnego.

Aplikacja musi przekazać wskaźnik do wcześniej przydzielonego wystąpienia _CrtMemState struktury zdefiniowanego w pliku Crtdbg.h w parametrze state . Jeśli _CrtMemCheckpoint wystąpi błąd podczas tworzenia punktu kontrolnego, funkcja generuje _CRT_WARN raport debugowania opisujący problem.

Aby uzyskać więcej informacji na temat funkcji stanu sterta i _CrtMemState struktury, zobacz Funkcje raportowania stanu stert. Aby uzyskać więcej informacji na temat przydzielania, inicjowania i zarządzania blokami pamięci w wersji debugowania sterty podstawowej, zobacz szczegóły sterty debugowania CRT.

Jeśli state parametr ma NULLwartość , wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, errno, , _sys_errlist_doserrno, i jest ustawiona na EINVAL , a _sys_nerr funkcja zwraca.

Wymagania

Procedura	Wymagany nagłówek
_CrtMemCheckpoint	<crtdbg.h>, <errno.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki: debugowanie tylko wersji narzędzia UCRT.

Zobacz też

Procedury debugowania
_CrtMemDifference