ORGetVirtualFlags 函式
擷取離線登錄區中指定開啟登錄機碼上的虛擬旗標。
語法
DWORD ORGetVirtualFlags(
_In_ ORHKEY Handle,
_Out_ PDWORD pdwFlags
);
參數
-
處理 [in]
-
離線登錄區中開啟登錄機碼的控制碼。
-
pdwFlags [out]
-
要接收金鑰所設定虛擬化旗標之變數的指標。 函式傳回之後，這個參數可以是下列一或多個值。
值 意義 - REG_KEY_DONT_SILENT_FAIL
- 4
如果設定此旗標，且開啟作業在已啟用虛擬化的機碼上失敗，登錄就不會嘗試重新開啟金鑰。 如果此旗標清楚，登錄會嘗試以MAXIMUM_ALLOWED存取重新開啟金鑰。 - REG_KEY_DONT_VIRTUALIZE
- 2
如果設定此旗標且建立金鑰作業失敗，因為呼叫端沒有父機碼上的KEY_CREATE_SUB_KEY許可權，登錄就會失敗建立作業。 如果此旗標清楚，登錄會嘗試在虛擬存放區中建立機碼。 呼叫端必須在父鍵上擁有KEY_READ。 - REG_KEY_RECURSE_FLAG
- 8
如果設定此旗標，則會從父機碼傳播登錄虛擬化旗標。 如果此旗標清楚，則不會傳播登錄虛擬化旗標。
傳回值
如果函式成功，傳回值會ERROR_SUCCESS。
如果函式失敗，傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤的一般描述。
備註
登錄虛擬化是一種過渡性應用程式相容性技術，可讓對全域造成影響的登錄寫入作業重新導向至每個使用者位置。 對讀取或寫入登錄的應用程式而言，此重新導向是透明的。
從 Windows Vista 開始，支援登錄虛擬化。 不過，Microsoft 想要從未來的 Windows 作業系統版本中移除它，因為更多應用程式與 Windows Vista 相容。 因此，應用程式不應該依賴系統中登錄虛擬化的行為。
僅針對下列專案啟用登錄虛擬化：
- 32 位互動式進程
- HKEY_LOCAL_MACHINE\Software中的索引鍵
- 系統管理員可寫入的金鑰
如需詳細資訊，請參閱 Registry Virtualization。
規格需求
| 需求 | 值 |
|---|---|
| 可轉散發套件 |
Windows 離線登錄程式庫 1.0 版或更新版本 |
| 標頭 |
|
| DLL |
|
另請參閱