ClusterRegCreateKey 函式 (clusapi.h)

發行項
02/28/2024

建立指定的叢集資料庫金鑰。如果密鑰已存在於資料庫中， ClusterRegCreateKey 就會開啟它，而不會進行變更。

語法

LONG ClusterRegCreateKey(
  [in]            HKEY                  hKey,
  [in]            LPCWSTR               lpszSubKey,
  [in]            DWORD                 dwOptions,
  [in]            REGSAM                samDesired,
  [in, optional]  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [out]           PHKEY                 phkResult,
  [out, optional] LPDWORD               lpdwDisposition
);

參數

[in] hKey

處理開啟的叢集資料庫金鑰。此參數不可為 NULL。

[in] lpszSubKey

Null 終止 Unicode 字串的指標，指定要建立或開啟之子機碼的名稱。 lpszSubKey 參數必須指向下列子機碼：

這是 hKey 所識別金鑰的子金鑰。
不得以反斜杠字元開頭 ( \ ) 。
不得為 NULL。

lpszSubKey 參數可以指向空字串，導致 ClusterRegCreateKey 傳回 hKey 所代表之資料庫密鑰的句柄。

[in] dwOptions

指定此索引鍵的特殊選項。目前 ，dwOptions 可以設定為下列值。

REG_OPTION_NON_VOLATILE (0x00000000)

已開啟或建立的索引鍵不是變動性;系統重新啟動時會保留資訊。

[in] samDesired

指定新金鑰所需安全性存取權的存取遮罩。下列值有效。

如需詳細資訊，請參閱登錄機碼安全性和訪問許可權。

ACCESS_SYSTEM_SECURITY (0x01000000)

存取系統安全性的許可權。它用來指出系統訪問控制清單的存取權， (SACL) 。這種類型的存取需要呼叫程式才能擁有 SE_SECURITY_NAME ( 管理稽核和安全性記錄) 許可權。

DELETE (0x00010000)

刪除的許可權。

KEY_ALL_ACCESS (0x000F003F)

KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS、KEY_NOTIFY、KEY_CREATE_SUB_KEY、KEY_CREATE_LINK和KEY_SET_VALUE存取的組合。

KEY_CREATE_LINK (0x00000020)

建立符號連結的許可權。

KEY_ENUMERATE_SUB_KEYS (0x00000008)

列舉子機碼的許可權。

KEY_EXECUTE (0x00020019)

讀取許可權。

KEY_NOTIFY (0x00000010)

變更通知的許可權。

KEY_QUERY_VALUE (0x00000001)

查詢子機碼數據的許可權。

KEY_READ (0x00020019)

KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS和KEY_NOTIFY存取的組合。

KEY_SET_VALUE (0x00000002)

變更子機碼數據的許可權。

KEY_WRITE (0x00020006)

KEY_SET_VALUE和KEY_CREATE_SUB_KEY存取的組合。

READ_CONTROL (0x00020000)

讀取安全性描述項之 DACL) (擁有者、群組和任意訪問控制清單的許可權。

WRITE_DAC (0x00040000)

寫入 DACL 的許可權。

WRITE_OWNER (0x00080000)

變更擁有者的許可權。

[in, optional] lpSecurityAttributes

這個參數已忽略。若要在新登錄機碼上設定安全性屬性，請在 ClusterRegCreateKey 成功傳回之後呼叫 ClusterRegSetKeySecurity 函式。

[out] phkResult

已開啟或已建立索引鍵句柄的指標。

[out, optional] lpdwDisposition

值的指標，描述 lpszSubKey 所指向的索引鍵是否已開啟或建立。下列值有效。

REG_CREATED_NEW_KEY (0x00000001)

索引鍵不存在且已建立。

REG_OPENED_EXISTING_KEY (0x00000002)

索引鍵已存在且已開啟。

傳回值

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

如果作業失敗，函式會傳回系統錯誤碼。

備註

呼叫端應該呼叫 ClusterRegCloseKey ，以關閉 ClusterRegCreateKey 函式完成時所建立的密鑰句柄。

請勿從下列資源 DLL 進入點函式呼叫 ClusterRegCreateKey ：

您可以從任何其他資源 DLL 進入點函式或背景工作線程安全地呼叫 ClusterRegCreateKey。如需詳細資訊，請參閱在資源 DLL 中避免的函式呼叫。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目標平台	Windows
標頭	clusapi.h
程式庫	ClusAPI.lib
Dll	ClusAPI.dll

另請參閱

共用方式為