Share via


CoTaskMemAlloc 함수(combaseapi.h)

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

구문

LPVOID CoTaskMemAlloc(
  [in] SIZE_T cb
);

매개 변수

[in] cb

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

반환 값

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

설명

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

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

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

요구 사항

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

추가 정보

CoTaskMemFree

CoTaskMemRealloc

IMalloc::Alloc