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 SDKの RegCreateKeyEx を参照してください。

  • samDesired
    キーのセキュリティ アクセス。既定値はです KEY_READ | KEY_WRITE.使用できる値の一覧とその説明については、RegCreateKeyExを参照してください。

  • lpSecAttr
    キーのハンドルを子プロセスが継承できるかどうかを示す SECURITY_ATTRIBUTES の構造体へのポインター。既定では、このパラメーターは null です (ハンドルを意味することは継承できません)。

  • lpdwDisposition
    (キーがあり、開いた) が (キーがなく、作成された場合) またはが null 以外の場合、[入力]取得されます。

戻り値

ただし、は、ERROR_SUCCESS キーを開きます成功した場合は。メソッドが失敗した場合、戻り値は WINERROR.H で定義されている以外のエラー コードです。

解説

[作成] はこのキーのハンドルに m_hKey のメンバーを設定します。

必要条件

atlbase.hHeader:

参照

関連項目

CRegKey クラス

CRegKey::Open

CRegKey::Close