Share via

CRegKey::Create

  • Article

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

Return Value

If successful, returns ERROR_SUCCESS; otherwise, an error value.

Parameters

hKeyParent

[in] The handle of an open key.

lpszKeyName

[in] Specifies the name of a key to be created or opened. This name must be a subkey of hKeyParent.

lpszClass

[in] Specifies the class of the key to be created or opened. The default value is REG_NONE.

dwOptions

[in] Options for the key. The default value is REG_OPTION_NON_VOLATILE. For a list of possible values and descriptions, see in the Win32 SDK.

samDesired

[in] The security access for the key. The default value is KEY_ALL_ACCESS. For a list of possible values and descriptions, see RegCreateKeyEx.

lpSecAttr

[in] A pointer to a structure that indicates whether the handle of the key can be inherited by a child process. By default, this parameter is NULL (meaning the handle cannot be inherited).

lpdwDisposition

[out] If non-NULL, retrieves either REG_CREATED_NEW_KEY (if the key did not exist and was created) or REG_OPENED_EXISTING_KEY (if the key existed and was opened).

Remarks

Creates the specified key if it does not exist as a subkey of hKeyParent. Otherwise, Create opens the key.

Create sets the m_hKey member to the handle of this key.

CRegKey Overview |  Class Members

See Also   CRegKey::Open, CRegKey::Close