CRegKey::Create

  • 發行項

如果不存在則為， hKeyParent子機碼呼叫這個方法會為指定的索引鍵。

LONG Create(
   HKEY hKeyParent,
   LPCTSTR lpszKeyName,
   LPTSTR lpszClass = REG_NONE,
   DWORD dwOptions = REG_OPTION_NON_VOLATILE,
   REGSAM samDesired = KEY_READ | KEY_WRITE,
   LPSECURITY_ATTRIBUTES lpSecAttr = NULL,
   LPDWORD lpdwDisposition = NULL 
) throw( );

參數

  • hKeyParent
    開啟金鑰的控制代碼。

  • lpszKeyName
    指定要建立或開啟機碼的名稱。這個名稱必須是 hKeyParent子機碼。

  • lpszClass
    指定要建立或開啟機碼的類別。預設值為 REG_NONE。

  • dwOptions
    金鑰的選項。預設值為 REG_OPTION_NON_VOLATILE。如需可能值的清單和描述，請參閱 Windows SDKRegCreateKeyEx 。

  • samDesired
    金鑰的安全性存取。預設值為 KEY_READ|KEY_WRITE.如需可能值的清單和描述，請參閱 RegCreateKeyEx。

  • lpSecAttr
    為指定的 SECURITY_ATTRIBUTES 結構指標索引鍵的子處理序是否可以繼承基礎控制代碼。根據預設，這個參數為 null (表示控制代碼無法繼承)。

  • lpdwDisposition
    [in]，如果非 Null，擷取 REG_CREATED_NEW_KEY (如果沒有索引鍵和建立) 或 (如果 REG_OPENED_EXISTING_KEY 索引鍵存在並已開啟)。

傳回值

如果成功，則傳回 ERROR_SUCCESS 和開啟金鑰。如果方法失敗，則傳回值是在 WINERROR.H. 定義的非零的錯誤碼。

備註

建立 設定 m_hKey 成員加入至這個金鑰控制代碼。

需求

Header: atlbase.h

請參閱

參考

CRegKey 類別

CRegKey::Open

CRegKey::Close