RegOpenKeyEx

von ActiveVB-Team

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
hKey	Das 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.
lpSubKey	Zeiger auf einen nullterminierten String, der den Namen des zuöffnenden Unterschlüssels enthält.
ulOptions	Reserviert, wird auf Null gesetzt.
samDesired	Sicherheits-Zugriffsmaske, siehe weiter unten.
phkResult	Das 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_LINK	Erlaubt das erstllen symbolischer Links für andere Unterschlüssel.
KEY_CREATE_SUB_KEY	Erlaubt Unterschlüssel zu erzeugen.
KEY_ENUMERATE_SUB_KEYS	Erlaubt die Auflistung von Unterschlüsseln
KEY_EXECUTE	KEY_QUERY_VALUE oder KEY_ENUMERATE_SUB_KEYS
KEY_NOTIFY	Aktiviert die Änderungsbenachrichtigung (unter Win95/98 nicht unterstützt)
KEY_QUERY_VALUE	Erlaubt, daß Unterschlüssel abgefragt werden.
KEY_READ	KEY_EXECUTE oder KEY_NOTIFY
KEY_SET_VALUE	Erlaubt, da0 Unterschlüssel geschrieben werden.
KEY_WRITE	KEY_CREATE_SUB_KEY oder KEY_SET_VALUE

Tabelle 2

Rückgabewerte
ERROR_SUCCESS	Der Schlüssel wurde erfolgreich geschlossen.
x	Der zugehörige Fehlercode

Tabelle 3

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

Verwandte API-Funktionen
RegCreateKeyEx, RegDeleteKey, RegOpenKey

Zugehörige Tipps

Anwendung nach Neustart automatisch starten [Tipp 0028]
Installationsverzeichnis und Version von VB suchen [Tipp 0032]
Paßwort des Bildschirmschoners auslesen [Tipp 0043]
Gesendete, empfangene Bytes und Geschwindigkeit einer DFÜ [Tipp 0055]
Registry lesen und schreiben, Schlüssel anlegen und löschen [Tipp 0107]
API-Fehlermeldungen ausgeben [Tipp 0190]
In der Registry browsen [Tipp 0209]
Andere Zeitzone setzen [Tipp 0341]
Prozessortyp ermitteln [Tipp 0420]
Proxyserver des Internet Explorer einstellen [Tipp 0514]
Programm mit Dateiendung assoziieren II [Tipp 0543]
REG_MULTI_SZ Werte in Registry schreiben und lesen [Tipp 0548]
Eigenes Protokoll definieren [Tipp 0563]
Testen, ob eine ActiveX-Dll registriert ist. [Tipp 0637]

Zugehörige Microsoft Knowledge Base Artikel