LockResource-Funktion (libloaderapi.h)

  • Artikel

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

Siehe auch

Konzept

Verweis