SHRegCreateUSKeyA 関数 (shlwapi.h)

[アーティクル]
08/26/2023

ユーザー固有のサブツリー (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 を使用してユーザー固有のレジストリキーを閉じます。

注意

shlwapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SHRegCreateUSKey を定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件


サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 4.71 以降)