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 |