SHRegSetValue 関数 (shlwapi.h)
サポートされていません。
レジストリ値を設定します。
その場所で RegSetValue を使用します。
構文
LSTATUS SHRegSetValue(
[in] HKEY hkey,
[in] LPCWSTR pszSubKey,
[in] LPCWSTR pszValue,
[in] SRRF srrfFlags,
[in] DWORD dwType,
[in] LPCVOID pvData,
[in] DWORD cbData
);
パラメーター
[in] hkey
種類: HKEY
現在開いているキーへのハンドル、または次の定義済みの値のいずれか。
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_USERS
[in] pszSubKey
種類: LPCWSTR
値を取得するサブ キーへの hkey からの相対パスを指定する null で終わる文字列へのポインター。 このパラメーターには NULL または空の文字列を指定できます。この場合、 データは hkey の場所から取得されます。
[in] pszValue
種類: LPCWSTR
値の名前を含む null で終わる文字列へのポインター。 このパラメーターには NULL または空の文字列を指定できます。この場合、データは既定値から取得されます。
[in] srrfFlags
種類: SRRF
設定するデータを制限する 1 つ以上の SRRF フラグ。 少なくとも 1 つの型制限 (SRRF_RT) 値を指定する必要があります。
[in] dwType
型: DWORD
設定する値に格納されているデータの種類を示す DWORD 。 既定値を使用する場合、入力 dwType は既定値の型です。 使用できる値については、「 レジストリ データ型」を参照してください。 SRRF_NOEXPAND フラグが設定されていない場合、REG_EXPAND_SZ型は自動的に展開され、REG_SZとして返されます。 型情報が必要ない場合は、このパラメーターに NULL を指定できます。
[in] pvData
種類: LPCVOID
値のデータを含むバッファーへのポインター。 データが不要な場合は、このパラメーターを NULL にすることができます 。
[in] cbData
型: DWORD
ソース データ バッファー pvData のサイズ (バイト単位)。 この値は、pvData が NULL の場合にのみ NULL にすることができます。
戻り値
型: LONG
成功した場合はERROR_SUCCESSを返し、それ以外の場合は Winerror.h で定義されている 0 以外のエラー コードを返します。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用して、エラーの一般的な説明を取得できます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shlwapi.h (Shlwapi.h を含む) |
[DLL] | Shlwapi.dll |