SHRegCreateUSKeyA 関数 (shlwapi.h)

ユーザー固有のサブツリー (HKEY_CURRENT_USERまたはHKEY_LOCAL_MACHINE) でレジストリ サブキーを作成または開きます。

構文

LSTATUS SHRegCreateUSKeyA(
  [in]           LPCSTR  pszPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           DWORD   dwFlags
);

パラメーター

[in] pszPath

種類: LPCTSTR

作成または開くサブキーを含む null で終わる文字列へのポインター。 この名前の値がサブキーに既に存在する場合は、その値が開かれます。

[in] samDesired

種類: REGSAM

目的のセキュリティ アクセス。 セキュリティ アクセスの詳細については、「 REGSAM」を参照してください。

[in, optional] hRelativeUSKey

タイプ: ハスキー

相対パスのベースとして使用するキー。 pszPath が相対パスの場合、指定するキーは hRelativeUSKey に対する相対パスになります。 pszPath が絶対パスの場合は、hRelativeUSKey を NULL に設定します。 その後、dwFlags の値に応じて、HKEY_LOCAL_MACHINEまたはHKEY_CURRENT_USERの下にキーが作成されます。

[out] phNewUSKey

種類: PHUSKEY

新しいキーへのハンドルを受け取る 、ハスキー へのポインター。

[in] dwFlags

型: DWORD

キーを開くベース キー。 次の値のうち 1 つ以上を指定できます。

SHREGSET_HKCU

[HKEY_CURRENT_USER] でキーを作成または開きます。 キーが空の場合にのみ作成されます。

SHREGSET_FORCE_HKCU

[HKEY_CURRENT_USER] でキーを作成または開きます。 空でない場合でもキーを作成します。

SHREGSET_HKLM

[HKEY_LOCAL_MACHINE] でキーを作成または開きます。 キーが空の場合にのみ作成されます。

SHREGSET_FORCE_HKLM

[HKEY_LOCAL_MACHINE] でキーを作成または開きます。 空でない場合でもキーを作成します。

SHREGSET_DEFAULT

HKEY_CURRENT_USER (強制) と HKEY_LOCAL_MACHINE の両方でキー を 作成または開きます (空の場合のみ)。 このフラグは、 (SHREGSET_FORCE_HKCU SHREGSET_HKLM | ) に相当します。

戻り値

種類: LSTATUS

成功した場合はERROR_SUCCESSを返し、それ以外の場合は Winerror.h で定義されている 0 以外のエラー コードを返します。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用して、エラーの一般的な説明を取得できます。

解説

新しいキーに値を書き込む場合は、SHRegWriteUSValue を使用して各値を書き込み、phNewUSKey を介して返されるハスキー ハンドルを渡します。 完了したら、 SHRegCloseUSKey を使用してユーザー固有のレジストリ キーを閉じます。

要件