ORSetVirtualFlags-Funktion
Legt Virtualisierungsflags für den angegebenen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur fest.
Syntax
DWORD ORSetVirtualFlags(
_In_ ORHKEY Handle,
_In_ DWORD dwFlags
);
Parameter
-
Handle [in]
-
Ein Handle für einen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur.
-
dwFlags [in]
-
Dieser Parameter steuert das Verhalten der Registrierung, wenn ein Create- oder Open-Vorgang für einen Schlüssel in einer virtualisierten Struktur fehlschlägt. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.
Wert Bedeutung - REG_KEY_DONT_SILENT_FAIL
- 4
Wenn dieses Flag festgelegt ist und ein Open-Vorgang für einen Schlüssel fehlschlägt, für den die Virtualisierung aktiviert ist, versucht die Registrierung nicht, den Schlüssel erneut zu öffnen. Wenn dieses Flag eindeutig ist, versucht die Registrierung, den Schlüssel mit dem MAXIMUM_ALLOWED Zugriff erneut zu öffnen. - REG_KEY_DONT_VIRTUALIZE
- 2
Wenn dieses Flag festgelegt ist und ein Vorgang zum Erstellen eines Schlüssels fehlschlägt, weil der Aufrufer nicht über das KEY_CREATE_SUB_KEY-Recht für den übergeordneten Schlüssel verfügt, schlägt die Registrierung den Create-Vorgang fehl. Wenn dieses Flag eindeutig ist, versucht die Registrierung, den Schlüssel im virtuellen Speicher zu erstellen. Der Aufrufer muss über die KEY_READ rechts auf dem übergeordneten Schlüssel verfügen. - REG_KEY_RECURSE_FLAG
- 8
Wenn dieses Flag festgelegt ist, werden Registrierungsvirtualisierungsflags vom übergeordneten Schlüssel weitergegeben. Wenn dieses Flag eindeutig ist, werden Registrierungsvirtualisierungsflags nicht weitergegeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in Winerror.h definierter Fehlercode ungleich null. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Bemerkungen
Die Registrierungsvirtualisierung ist eine zwischenzeitliche Anwendungskompatibilitätstechnologie, mit der Schreibvorgänge von Registrierungen, die globale Auswirkungen haben, an benutzerspezifische Standorte umgeleitet werden können. Diese Umleitung ist für Anwendungen transparent, die aus der Registrierung lesen oder in diese schreiben.
Die Registrierungsvirtualisierung wird ab Windows Vista unterstützt. Microsoft beabsichtigt jedoch, es aus zukünftigen Versionen des Windows-Betriebssystems zu entfernen, da mehr Anwendungen mit Windows Vista kompatibel gemacht werden. Daher sollten Anwendungen nicht vom Verhalten der Registrierungsvirtualisierung im System abhängen.
Die Registrierungsvirtualisierung ist nur für Folgendes aktiviert:
- Interaktive 32-Bit-Prozesse
- Schlüssel in HKEY_LOCAL_MACHINE\Software
- Schlüssel, in die ein Administrator schreiben kann
Weitere Informationen finden Sie unter Registrierungsvirtualisierung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Verteilbare Komponente |
Windows-Offlineregistrierungsbibliothek, Version 1.0 oder höher |
| Header |
|
| DLL |
|
Siehe auch