IGroupPolicyObject::GetRegistryKey-Methode (gpedit.h)
Die GetRegistryKey-Methode ruft ein Handle im Stammverzeichnis des Registrierungsschlüssels für den angegebenen GPO-Abschnitt ab.
Syntax
HRESULT GetRegistryKey(
[in] DWORD dwSection,
[out] HKEY *hKey
);
Parameter
[in] dwSection
Gibt den Abschnitt "Gruppenrichtlinienobjekt" an. Dieser Parameter kann einen der folgenden Werte annehmen.
GPO_SECTION_ROOT
Stammabschnitt
GPO_SECTION_MACHINE
Abschnitt "Computer"
[out] hKey
Empfängt ein Handle für den Registrierungsschlüssel. Dieses Handle wird mit allen Zugriffsrechten geöffnet. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der COM-Fehlercodes zurück, die in der Platform SDK-Headerdatei WinError.h definiert sind. Wenn die Registrierungsinformationen nicht geladen werden, gibt die Methode E_FAIL zurück.
Hinweise
Das Registrierungshandle ist ein Handle für den Stamm des Registrierungsschlüssels. Um Werte im Richtlinienschlüssel abzurufen oder festzulegen, rufen Sie zuerst die RegOpenKey-Funktion auf, um die Software zu öffnen.
Richtlinienschlüssel.
Wenn Sie die Verwendung des Registrierungshandles abgeschlossen haben, rufen Sie die RegCloseKey-Funktion auf, um das Handle zu schließen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | gpedit.h |
| DLL | Gpedit.dll |
Weitere Informationen
Gruppenrichtlinie Schnittstellen