SHRegCreateUSKeyW 関数 (shlwapi.h)

[アーティクル]
11/20/2024

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

構文

LSTATUS SHRegCreateUSKeyW(
                 LPCWSTR pwzPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           DWORD   dwFlags
);

パラメーター

pwzPath

未定

[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 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	shlwapi.h
ライブラリ	Shlwapi.lib
DLL	Shlwapi.dll (バージョン 4.71 以降)

次の方法で共有