ORGetVirtualFlags-Funktion

Ruft die virtuellen Flags für den angegebenen offenen 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 es sich bei diesem Parameter um einen oder mehrere der folgenden Werte handeln.

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 MAXIMUM_ALLOWED Zugriff erneut zu öffnen.
REG_KEY_DONT_VIRTUALIZE 2	Wenn dieses Flag festgelegt ist und ein Schlüssel erstellen-Vorgang fehlschlägt, weil der Aufrufer nicht über das KEY_CREATE_SUB_KEY Rechte auf dem übergeordneten Schlüssel verfügt, schlägt die Registrierung den Vorgang Erstellen fehl. Wenn dieses Flag eindeutig ist, versucht die Registrierung, den Schlüssel im virtuellen Speicher zu erstellen. Der Aufrufer muss die KEY_READ rechts auf dem übergeordneten Schlüssel haben.
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 nichtzero-Fehlercode, der in Winerror.h definiert ist. 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 Zwischenanwendungskompatibilitätstechnologie, mit der Registrierungsschreibvorgänge, die globale Auswirkungen haben, an Benutzerstandorte 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

Siehe auch

ORSetVirtualFlags

Registrierungsvirtualisierung