ORGetVirtualFlags-Funktion
Ruft die virtuellen Flags für den angegebenen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur ab.
Syntax
DWORD ORGetVirtualFlags(
_In_ ORHKEY Handle,
_Out_ PDWORD pdwFlags
);
Parameter
-
Handle [ In]
-
Ein Handle für einen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur.
-
pdwFlags [ out]
-
Ein Zeiger auf eine Variable, um die für den Schlüssel festgelegten Virtualisierungsflags zu empfangen. Nachdem die Funktion zurückgegeben wurde, kann dieser Parameter mindestens einen der folgenden Werte aufweisen.
Wert Bedeutung - REG _ KEY _ DONT _ SILENT _ FAIL
- 4
Wenn dieses Flag festgelegt ist und bei einem Schlüssel mit aktivierter Virtualisierung ein Open-Vorgang fehlschlägt, versucht die Registrierung nicht, den Schlüssel erneut zu öffnen. Wenn dieses Flag eindeutig ist, versucht die Registrierung, den Schlüssel mit maximal zulässigem 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 die Berechtigung KEY _ CREATE SUB KEY für den _ _ übergeordneten Schlüssel verfügt, schlägt die Registrierung den Erstellungsvorgang fehl. Wenn dieses Flag eindeutig ist, versucht die Registrierung, den Schlüssel im virtuellen Speicher zu erstellen. Der Aufrufer muss über die BERECHTIGUNG KEY _ READ für den ü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 ausgeführt wird, lautet der Rückgabewert ERROR _ SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode ungleich 0 (null), der in Winerror.h definiert ist. Sie können die FormatMessage-Funktion mit dem _ FORMAT MESSAGE FROM _ _ SYSTEM-Flag verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Hinweise
Die Registrierungsvirtualisierung ist eine Zwischenanwendungskompatibilitätstechnologie, mit der Schreibvorgänge für Registrierungen, die globale Auswirkungen haben, an benutzerspezifische Speicherorte umgeleitet werden können. Diese Umleitung ist für Anwendungen transparent, die aus der Registrierung lesen oder in die Registrierung 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 Registry Virtualization.
Anforderungen
| Anforderung | Wert |
|---|---|
| Verteilbare Komponente |
Windows Offline registry library version 1.0 or later (Offlineregistrierungsbibliothek, Version 1.0 oder höher) |
| Header |
|
| DLL |
|