Fungsi CoTaskMemAlloc (combaseapi.h)
Mengalokasikan blok memori tugas dengan cara yang sama seperti yang dilakukan IMalloc::Alloc .
Sintaks
LPVOID CoTaskMemAlloc(
[in] SIZE_T cb
);
Parameter
[in] cb
Ukuran blok memori yang akan dialokasikan, dalam byte.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan blok memori yang dialokasikan. Jika tidak, ia mengembalikan NULL.
Keterangan
CoTaskMemAlloc menggunakan alokator default untuk mengalokasikan blok memori dengan cara yang sama seperti yang dilakukan IMalloc::Alloc . Tidak perlu memanggil fungsi CoGetMalloc sebelum memanggil CoTaskMemAlloc.
Konten awal blok memori yang dikembalikan tidak terdefinisi - tidak ada jaminan bahwa blok telah diinisialisasi. Blok yang dialokasikan mungkin lebih besar dari byte cb karena ruang yang diperlukan untuk penyelarasan dan untuk informasi pemeliharaan.
Jika cb adalah 0, CoTaskMemAlloc mengalokasikan item panjang nol dan mengembalikan penunjuk yang valid ke item tersebut. Jika memori tidak tersedia, CoTaskMemAlloc mengembalikan NULL. Aplikasi harus selalu memeriksa nilai pengembalian dari fungsi ini, bahkan ketika meminta sejumlah kecil memori, karena tidak ada jaminan bahwa memori akan dialokasikan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | combaseapi.h (termasuk Objbase.h) |
Pustaka | Ole32.lib |
DLL | Ole32.dll |