Freigeben über


IMallocSpy::P reAlloc-Methode (objidl.h)

Führt Vorgänge aus, die vor dem Aufruf von IMalloc::Alloc erforderlich sind.

Syntax

SIZE_T PreAlloc(
  [in] SIZE_T cbRequest
);

Parameter

[in] cbRequest

Die Anzahl von Bytes, die in der Zuordnungsanforderung angegeben ist, die der Aufrufer an Alloc übergibt.

Rückgabewert

Die Im Aufruf von Alloc angegebene Anzahl von Bytes, die größer oder gleich dem Wert von cbRequest sein kann.

Hinweise

Die PreAlloc-Implementierung kann die Zuordnung erweitern und/oder ändern, um debugspezifische Informationen mit der Zuordnung zu speichern.

PreAlloc kann einen Speicherbelegungsfehler erzwingen, indem 0 zurückgegeben wird, sodass Tests sicherstellen können, dass die Anwendung Zuordnungsfehler in allen Fällen ordnungsgemäß behandelt. In diesem Fall wird IMallocSpy::P ostAlloc nicht aufgerufen, und Alloc gibt NULL zurück. Das Erzwingen eines Zuordnungsfehlers ist nur wirksam, wenn cbRequest nicht gleich 0 ist. Wenn PreAlloc einen Fehler erzwingt, indem NULL zurückgegeben wird, wird PostAlloc nicht aufgerufen. Bei Alloc tritt jedoch ein echter Speicherfehler auf und gibt NULL zurück, PostAlloc wird aufgerufen.

Der Aufruf von PreAlloc über die Rückgabe von PostAlloc ist garantiert threadsicher.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidl.h

Weitere Informationen

IMalloc::Alloc

IMallocSpy

IMallocSpy::P ostAlloc