CoTaskMemAlloc 함수(combaseapi.h)

IMalloc::Alloc와 동일한 방식으로 작업 메모리 블록을 할당합니다.

구문

LPVOID CoTaskMemAlloc(
  [in] SIZE_T cb
);

매개 변수

[in] cb

할당할 메모리 블록의 크기(바이트)입니다.

반환 값

함수가 성공하면 할당된 메모리 블록을 반환합니다. 그렇지 않으면 NULL을 반환합니다.

설명

CoTaskMemAlloc 는 기본 할당자를 사용하여 IMalloc::Alloc 와 동일한 방식으로 메모리 블록을 할당합니다. CoTaskMemAlloc를 호출하기 전에 CoGetMalloc 함수를 호출할 필요는 없습니다.

반환된 메모리 블록의 초기 콘텐츠는 정의되지 않습니다. 블록이 초기화되었다는 보장은 없습니다. 정렬 및 유지 관리 정보에 필요한 공간 때문에 할당된 블록이 cb 바이트보다 클 수 있습니다.

cb가 0이면 CoTaskMemAlloc에서 길이가 0인 항목을 할당하고 해당 항목에 대한 유효한 포인터를 반환합니다. 사용 가능한 메모리가 부족한 경우 CoTaskMemAlloc 은 NULL을 반환합니다. 메모리가 할당된다는 보장은 없으므로 적은 양의 메모리를 요청하는 경우에도 애플리케이션은 항상 이 함수의 반환 값을 검사 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	combaseapi.h(Objbase.h 포함)
라이브러리	Ole32.lib
DLL	Ole32.dll

추가 정보

CoTaskMemFree

CoTaskMemRealloc

IMalloc::Alloc