GlobalHandle-Funktion (winbase.h)

  • Artikel

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

Siehe auch

Globale und lokale Funktionen

Globalalloc

GlobalLock

Speicherverwaltungsfunktionen