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 |