Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft das Handle ab, das dem angegebenen Zeiger auf ein lokales Speicherobjekt zugeordnet ist.
Hinweis Die lokalen Funktionen weisen einen höheren Mehraufwand auf und bieten weniger Features als andere Speicherverwaltungsfunktionen. Neue Anwendungen sollten die Heapfunktionen verwenden, es sei denn, die Dokumentation besagt, dass eine lokale Funktion verwendet werden soll. Weitere Informationen finden Sie unter Globale und lokale Funktionen.
Syntax
HLOCAL LocalHandle(
[in] LPCVOID pMem
);
Parameter
[in] pMem
Ein Zeiger auf das erste Byte des lokalen Speicherobjekts. Dieser Zeiger wird von der LocalLock-Funktion zurückgegeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das angegebene lokale Speicherobjekt.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn die LocalAlloc-Funktion ein lokales Speicherobjekt mit LMEM_MOVEABLE zuordnet, gibt sie ein Handle an das Objekt zurück. Die LocalLock-Funktion konvertiert dieses Handle in einen Zeiger auf den Speicherblock des Objekts, und LocalHandle konvertiert den Zeiger wieder in ein Handle.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |