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
Offreg.h
DLL
Offreg.dll

Siehe auch

ORSetVirtualFlags

Registrierungsvirtualisierung