共用方式為


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 版或更新版本
標頭
Offreg.h
DLL
Offreg.dll

另請參閱

ORSetVirtualFlags

登錄虛擬化