Die Community zu .NET und Classic VB.
Menü

RegOpenKeyEx

 von 

Deklaration  

Declare Function RegOpenKeyEx Lib "advapi32.dll" _
                 Alias "RegOpenKeyExA" ( _
                 ByVal hKey As Long, _
                 ByVal lpSubKey As String, _
                 ByVal ulOptions As Long, _
                 ByVal samDesired As Long, _
                 phkResult As Long) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel RegOpenKeyEx des API-Wikis.

RegOpenKeyEx öffnet einen Registry-Unterschlüssel.

Parameter
hKeyDas Handle eines Schlüssels, der der Elternschlüssel des zu öffnenden Unterschlüssels ist. Dabei kann es sich um einen geöffneten Schlüssel oder einen der vor definfierten Hauptschlüssel HKEY_CLASSES_ROOT , HKEY_CURRENT_USER , HKEY_LOCAL_MACHINE , HKEY_USERS, HKEY_PERFORMANCE_DATA , HKEY_CURRENT_CONFIG , HKEY_DYN_DATA handeln.
lpSubKeyZeiger auf einen nullterminierten String, der den Namen des zuöffnenden Unterschlüssels enthält.
ulOptionsReserviert, wird auf Null gesetzt.
samDesiredSicherheits-Zugriffsmaske, siehe weiter unten.
phkResultDas Handle des geöffneten Unterschlüssels.

Tabelle 1


Optionen für den Zugriff [samDesired]
KEY_ALL_ACCESS KEY_CREATE_LINK , KEY_READ oder KEY_WRITE
KEY_CREATE_LINKErlaubt das erstllen symbolischer Links für andere Unterschlüssel.
KEY_CREATE_SUB_KEYErlaubt Unterschlüssel zu erzeugen.
KEY_ENUMERATE_SUB_KEYSErlaubt die Auflistung von Unterschlüsseln
KEY_EXECUTE KEY_QUERY_VALUE oder KEY_ENUMERATE_SUB_KEYS
KEY_NOTIFYAktiviert die Änderungsbenachrichtigung (unter Win95/98 nicht unterstützt)
KEY_QUERY_VALUEErlaubt, daß Unterschlüssel abgefragt werden.
KEY_READ KEY_EXECUTE oder KEY_NOTIFY
KEY_SET_VALUEErlaubt, da0 Unterschlüssel geschrieben werden.
KEY_WRITEKEY_CREATE_SUB_KEY oder KEY_SET_VALUE

Tabelle 2


Rückgabewerte
ERROR_SUCCESSDer Schlüssel wurde erfolgreich geschlossen.
xDer zugehörige Fehlercode

Tabelle 3


Unterstützte Betriebssysteme
Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
RegCreateKeyEx, RegDeleteKey, RegOpenKey

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel