LocalHandle-Funktion (winbase.h)

  • Artikel

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

Siehe auch

Globale und lokale Funktionen

LocalAlloc

LocalLock

Speicherverwaltungsfunktionen