IMalloc::Alloc メソッド (objidl.h)

メモリのブロックを割り当てます。

構文

void * Alloc(
  [in] SIZE_T cb
);

[in] cb

割り当てるメモリブロックのサイズ (バイト単位)。

メソッドが成功した場合、戻り値は割り当てられたメモリブロックへのポインターです。それ以外の場合は NULL です。

メモリが割り当てられる保証がないため、少量のメモリを要求する場合でも、アプリケーションは常にこのメソッドからの戻り値をチェックする必要があります。

返されるメモリブロックの初期内容は未定義であり、ブロックが初期化されている保証がないため、コードで初期化する必要があります。アラインメントとメンテナンス情報に必要な領域が原因で、割り当てられたブロックが cb バイトを超える場合があります。

cb が 0 の場合、Alloc は長さ 0 の項目を割り当て、その項目への有効なポインターを返します。使用可能なメモリが不足している場合、 Alloc は NULL を返します。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	objidl.h