SHSetValueA 関数 (shlwapi.h)
レジストリ キーの値を設定します。
構文
LSTATUS SHSetValueA(
[in] HKEY hkey,
[in, optional] LPCSTR pszSubKey,
[in, optional] LPCSTR pszValue,
[in] DWORD dwType,
[in, optional] 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, optional] pszSubKey
種類: LPCTSTR
値が関連付けられているサブキーの名前を指定する null で終わる文字列のアドレス。 NULL または空 の文字列へのポインターを指定できます。 この場合、 hkey パラメーターによって識別されるキーに値が追加されます。
[in, optional] pszValue
種類: LPCTSTR
値を指定する null で終わる文字列のアドレス。 この値には NULL を指定できます。
[in] dwType
型: DWORD
格納するデータの種類。 このパラメーターは 、REG_SZ 型である必要があります。 詳細については、「 レジストリ データ型」を参照してください。
[in, optional] pvData
種類: LPCVOID
指定した値に設定するデータを含むバッファーへのポインター。 この値には NULL を指定できます。
[in] cbData
型: DWORD
pvData パラメーターが指すバッファーの長さ (バイト単位)。 データが null で終わる文字列の場合、この長さには終端の null 文字が含まれます。
戻り値
種類: LSTATUS
成功した場合はERROR_SUCCESSを返します。それ以外の場合は、Winerror.h で定義されている 0 以外のエラー コード。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用して、エラーの一般的な説明を取得できます。
注釈
注意
shlwapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SHSetValue を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shlwapi.h |
Library | Shlwapi.lib |
[DLL] | Shlwapi.dll (バージョン 4.71 以降) |