LockResource-Funktion (libloaderapi.h)
Ruft einen Zeiger auf die angegebene Ressource im Arbeitsspeicher ab.
Syntax
LPVOID LockResource(
[in] HGLOBAL hResData
);
Parameter
[in] hResData
Typ: HGLOBAL
Ein Handle für die Ressource, auf die zugegriffen werden soll. Die LoadResource-Funktion gibt dieses Handle zurück. Beachten Sie, dass dieser Parameter nur aus Gründen der Abwärtskompatibilität als HGLOBAL-Variable aufgeführt wird. Übergeben Sie keinen Wert als einen anderen Parameter als einen erfolgreichen Rückgabewert aus der LoadResource-Funktion .
Rückgabewert
Typ: LPVOID
Wenn die geladene Ressource verfügbar ist, ist der Rückgabewert ein Zeiger auf das erste Byte der Ressource. andernfalls ist es NULL.
Hinweise
Der von LockResource zurückgegebene Zeiger ist gültig, bis das Modul, das die Ressource enthält, entladen wird. Es ist nicht erforderlich, Ressourcen zu entsperren, da das System sie automatisch löscht, wenn der Prozess, der sie erstellt hat, beendet wird.
Versuchen Sie nicht, eine Ressource mithilfe des Von der FindResourceA-Funktion oder der FindResourceExA-Funktionsfunktion zurückgegebenen Handle zu sperren. Ein solches Handle verweist auf zufällige Daten.
Hinweis
LockResource sperrt den Arbeitsspeicher nicht. Es wird nur verwendet, um einen Zeiger auf den Speicher zu erhalten, der die Ressourcendaten enthält. Der Name der Funktion stammt aus Versionen vor Windows XP, als sie zum Sperren eines globalen Speicherblocks verwendet wurde, der von LoadResource zugewiesen wurde.
Beispiele
Ein Beispiel finden Sie unter Aktualisieren von Ressourcen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | libloaderapi.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |