schlüsselwort sh _ reg _ key

Das Schlüsselwort sh _ reg _ key gibt an, dass system_handle ein ein Handle für einen Registrierungsschlüssel enthält.

[system_handle(sh_reg_key)]

[system_handle(sh_reg_key, access-rights)]

Parameter

Dieses Schlüsselwort ist ein Parameter für system_handle.

Die system_handle-Dokumentation enthält auch Details zur optionalen Verwendung des Access-Rights-Parameters. Das Standardverhalten entspricht DUPLICATE_SAME_ACCESS den DuplicateHandle-Funktionsspezifikationen.

Hinweise

Um dieses Schlüsselwort mit dem -Attribut verwenden zu system_handle können, muss das -target Flag beim Ausführen von midl.exe auf NT100 (oder höher) festgelegt werden.

Beispiele

interface MyInterface : IUnknown                         
{         
    HRESULT GetConfigurationKey([out, system_handle(sh_reg_key)] HANDLE* key);

    HRESULT SetKeyForWatch([in, system_handle(sh_reg_key, KEY_READ)] HANDLE watchKey);
}

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10 Anniversary Update (Version 1607, Build 14393)
Unterstützte Mindestversion (Server) Windows Server 2016 (Build 14393)

Weitere Informationen

system_handle

Registrierung

Sicherheit und Zugriffsrechte für Registrierungsschlüssel

RegOpenKeyEx-Funktion