ORCreateHive 函式

建立包含單一空白根機碼的離線登錄區。

語法

DWORD ORCreateHive(
  _Out_ PORHKEY phkResult
);

phkResult [out]: 指向變數，以接收新建立之離線登錄區根機碼的控制碼。如果無法建立 Hive，函式會將此參數設定為 Null。

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值是 Winerror.h 中定義的非零錯誤碼。您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤的一般描述。

如果記憶體不足而無法建立登錄區，函式會傳回ERROR_NOT_ENOUGH_MEMORY。

ORCreateHive函式會在記憶體中建立空白的離線登錄區。使用 ORCreateKey 和 ORSetValue 函式來新增索引鍵並設定其值。