GlobalHandle-Funktion (winbase.h)
Ruft das Handle ab, das dem angegebenen Zeiger auf einen globalen Speicherblock zugeordnet ist.
Hinweis Die globalen 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 globale Funktion verwendet werden soll. Weitere Informationen finden Sie unter Globale und lokale Funktionen.
Syntax
HGLOBAL GlobalHandle(
[in] LPCVOID pMem
);
Parameter
[in] pMem
Ein Zeiger auf das erste Byte des globalen Speicherblocks. Dieser Zeiger wird von der GlobalLock-Funktion zurückgegeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das angegebene globale 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 GlobalAlloc-Funktion ein Speicherobjekt mit GMEM_MOVEABLE zuordnet, gibt sie ein Handle an das Objekt zurück. Die GlobalLock-Funktion konvertiert dieses Handle in einen Zeiger auf den Speicherblock, und GlobalHandle 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 |