CRegKey::Create

如果它不存在),作为 hKeyParent,child调用此方法创建指定的键。

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 SDK的 RegCreateKeyEx

  • samDesired
    关键的安全访问。 默认值为KEY_READ|KEY_WRITE. 有关可能的值和说明的列表,请参见 RegCreateKeyEx

  • lpSecAttr
    到指定的 SECURITY_ATTRIBUTES 结构的指针键的句柄是否可由子进程继承。 默认情况下,此参数为NULL (表示句柄不能继承)。

  • lpdwDisposition
    [out] 如果非null,检索REG_CREATED_NEW_KEY (如果该项不存在且已创建了)或REG_OPENED_EXISTING_KEY (如果此键已存在并在中打开的)。

返回值

如果成功,则返回ERROR_SUCCESS并打开键。 如果方法失败,则返回值是在WINERROR.H.定义的一个非零错误代码。

备注

Create 设置 m_hKey 成员添加到此密钥句柄。

要求

Header: atlbase.h

请参见

参考

CRegKey选件类

CRegKey::Open

CRegKey::Close