_CrtSetBreakAlloc

지정된 개체 할당 순서 번호에 대한 중단점을 설정합니다(디버그 버전에만 해당).

구문

long _CrtSetBreakAlloc(
   long lBreakAlloc
);

매개 변수

lBreakAlloc
중단점을 설정할 할당 순서 번호입니다.

반환 값

중단점이 설정된 이전 개체 할당 순서 번호를 반환합니다.

설명

_CrtSetBreakAlloc은 애플리케이션에서 메모리 할당의 특정 지점에서 중단한 다음 요청의 원점으로 다시 추적하여 메모리 누수 검색을 수행하도록 허용합니다. 메모리 블록에 할당된 순차적 개체 할당 순서 번호가 힙에서 할당된 경우 이 함수는 이 번호를 사용합니다. _DEBUG가 정의되지 않은 경우 전처리 중에 _CrtSetBreakAlloc에 대한 호출이 제거됩니다.

개체 할당 순서 번호는 Crtdbg.h에 정의된 _CrtMemBlockHeader 구조체의 lRequest 필드에 저장됩니다. 디버그 덤프 함수 중 하나가 메모리 블록에 대한 정보를 보고하면 이 번호는 중괄호로 묶어 표시합니다(예: {36}).

다른 메모리 관리 함수와 함께 _CrtSetBreakAlloc을 사용하는 방법에 대한 자세한 내용은 힙 할당 요청 추적을 참조하세요. 기본 힙의 디버그 버전에서 메모리 블록을 할당, 초기화 및 관리하는 방법에 대한 자세한 내용은 CRT 디버그 힙 세부 정보를 참조하세요.

요구 사항

루틴에서 반환된 값	필수 헤더
_CrtSetBreakAlloc	<crtdbg.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

라이브러리

C 런타임 라이브러리의 디버그 버전만 해당됩니다.

예시

// crt_setbrkal.c
// compile with: -D_DEBUG /MTd -Od -Zi -W3 /c /link -verbose:lib -debug

/*
* In this program, a call is made to the _CrtSetBreakAlloc routine
* to verify that the debugger halts program execution when it reaches
* a specified allocation number.
*/

#include <malloc.h>
#include <crtdbg.h>

int main( )
{
        long allocReqNum;
        char *my_pointer;

        /*
         * Allocate "my_pointer" for the first
         * time and ensure that it gets allocated correctly
         */
        my_pointer = malloc(10);
        _CrtIsMemoryBlock(my_pointer, 10, &allocReqNum, NULL, NULL);

        /*
         * Set a breakpoint on the allocation request
         * number for "my_pointer"
         */
        _CrtSetBreakAlloc(allocReqNum+2);

        /*
         * Alternate freeing and reallocating "my_pointer"
         * to verify that the debugger halts program execution
         * when it reaches the allocation request
         */
        free(my_pointer);
        my_pointer = malloc(10);
        free(my_pointer);
        my_pointer = malloc(10);
        free(my_pointer);
}

참고 항목

디버그 루틴