次の方法で共有

RegGetValueA 関数 (winreg.h)

  • [アーティクル]

指定したレジストリ値の型とデータを取得します。

構文

LSTATUS RegGetValueA(
  [in]                HKEY    hkey,
  [in, optional]      LPCSTR  lpSubKey,
  [in, optional]      LPCSTR  lpValue,
  [in, optional]      DWORD   dwFlags,
  [out, optional]     LPDWORD pdwType,
  [out, optional]     PVOID   pvData,
  [in, out, optional] LPDWORD pcbData
);

パラメーター

[in] hkey

開いているレジストリ キーへのハンドル。 キーは、KEY_QUERY_VALUEアクセス権で開かれている必要があります。 詳細については、「レジストリ キーのセキュリティとアクセス権のを する」を参照してください。

このハンドルは、RegCreateKeyEx、RegCreateKeyTransacted、RegOpenKeyEx、または RegOpenKeyTransacted 関数 返されます。 また、次のいずれかの定義済みキー することもできます。

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_PERFORMANCE_NLSTEXT
HKEY_PERFORMANCE_TEXT
HKEY_USERS

[in, optional] lpSubKey

hkey パラメーターで指定されたキーを基準としたレジストリ キーのパス。 レジストリ値は、このサブキーから取得されます。

パスでは大文字と小文字は区別されません。

このパラメーターが NULL または空の文字列 "" 場合、hkey 自体 指定されたキーから値が読み取られます。

[in, optional] lpValue

レジストリ値の名前。

このパラメーターが NULL または空の文字列 "" 場合、関数はキーの名前のない値または既定値 (存在する場合) の型とデータを取得します。 キーには名前のない値または既定値は自動的に設定されず、名前のない値は任意の型にすることができます。

詳細については、「レジストリ要素のサイズ制限」を参照してください。

[in, optional] dwFlags

クエリする値のデータ型を制限するフラグ。 値のデータ型がこの条件を満たしていない場合、関数は失敗します。 このパラメーターには、次の値のうち 1 つ以上を指定できます。

価値 意味
RRF_RT_ANY
0x0000ffff
 型の制限はありません。
RRF_RT_DWORD
0x00000018
 型を 32 ビット RRF_RT_REG_BINARYに制限する |RRF_RT_REG_DWORD。
RRF_RT_QWORD
0x00000048
 型を 64 ビット RRF_RT_REG_BINARYに制限する |RRF_RT_REG_QWORD。
RRF_RT_REG_BINARY
0x00000008
 型をREG_BINARYに制限します。
RRF_RT_REG_DWORD
0x00000010
 型をREG_DWORDに制限します。
RRF_RT_REG_EXPAND_SZ
0x00000004
 型をREG_EXPAND_SZに制限します。
RRF_RT_REG_MULTI_SZ
0x00000020
 型をREG_MULTI_SZに制限します。
RRF_RT_REG_NONE
0x00000001
 型をREG_NONEに制限します。
RRF_RT_REG_QWORD
0x00000040
 型をREG_QWORDに制限します。
RRF_RT_REG_SZ
0x00000002
 型をREG_SZに制限します。
 

このパラメーターには、次の値の 1 つ以上を含めることもできます。

価値 意味
RRF_NOEXPAND
0x10000000
 値が REG_EXPAND_SZ 型の場合は、環境文字列を自動的に展開しないでください。
RRF_ZEROONFAILURE
0x20000000
 pvData NULLされていない場合は、障害発生時にバッファーの内容をゼロに設定します。
RRF_SUBKEY_WOW6464KEY
0x00010000
 lpSubKey NULLされていない場合は、lpSubKey が指定 サブキーをKEY_WOW64_64KEYアクセス権で開きます。 これらのアクセス権の詳細については、「レジストリ キーのセキュリティとアクセス権の」を参照してください。

RRF_SUBKEY_WOW6432KEYと組み合わせて RRF_SUBKEY_WOW6464KEY を指定することはできません。
RRF_SUBKEY_WOW6432KEY
0x00020000
 lpSubKey NULLされていない場合は、lpSubKey が指定 サブキーをKEY_WOW64_32KEYアクセス権で開きます。 これらのアクセス権の詳細については、「レジストリ キーのセキュリティとアクセス権の」を参照してください。

RRF_SUBKEY_WOW6464KEYと組み合わせて RRF_SUBKEY_WOW6432KEY を指定することはできません。

[out, optional] pdwType

指定した値に格納されているデータの型を示すコードを受け取る変数へのポインター。 使用可能な型コードの一覧については、「レジストリ値の型参照してください。 型が不要な場合、このパラメーターは NULL できます。

[out, optional] pvData

値のデータを受け取るバッファーへのポインター。 データが不要な場合、このパラメーターは NULL できます。

データが文字列の場合、関数は終端 null 文字をチェックします。 見つからない場合、バッファーが余分な文字を格納するのに十分な大きさの場合、文字列は null ターミネータと共に格納されます。 それ以外の場合、関数は失敗し、ERROR_MORE_DATAを返します。

[in, out, optional] pcbData

pvData パラメーターが指すバッファーのサイズをバイト単位で指定する変数へのポインター。 関数から制御が戻ると、この変数には、pvDataにコピー データのサイズが格納されます。

pcbData パラメーターは、pvData が NULL場合にのみ、NULL できます。

データにREG_SZ、REG_MULTI_SZ、またはREG_EXPAND_SZの型がある場合、このサイズには、null 文字または文字 終端が含まれます。 詳細については、「解説」を参照してください。

pvData パラメーター 指定されたバッファーがデータを保持するのに十分な大きさでない場合、関数はERROR_MORE_DATAを返し、必要なバッファー サイズ pcbDataが指す変数に格納します。 この場合、dwFlags がRRF_ZEROONFAILUREを指定し、それ以外の場合は未定義の場合、pvData バッファーの内容は 0 になります。

pvData が NULL場合、および pcbData が非NULLである場合、この関数はERROR_SUCCESSを返し、データのサイズをバイト単位で pcbData指す変数に格納します。 これにより、アプリケーションは値のデータにバッファーを割り当てる最適な方法を決定できます。

hKey が HKEY_PERFORMANCE_DATA を指定し、pvData バッファーが返されるすべてのデータを格納するのに十分な大きさでない場合、関数はERROR_MORE_DATAを返し、pcbData パラメーターを介して返される値は未定義です。 これは、パフォーマンス データのサイズが 1 つの呼び出しから次の呼び出しに変わる可能性があるためです。 この場合は、バッファー サイズを大きくし、pcbData パラメーターで更新されたバッファー サイズを渡 RegGetValue を呼び出す必要があります。 関数が成功するまで、これを繰り返します。 pcbData によって返される値は予測できないため、バッファー サイズを追跡するために別の変数を保持する必要があります。

戻り値

関数が成功した場合、戻り値はERROR_SUCCESS。

関数が失敗した場合、戻り値はシステム エラー コードです。

pvData バッファーが小さすぎて値を受け取れなければ、関数はERROR_MORE_DATAを返します。

lpValue レジストリ値が存在しない場合、関数はERROR_FILE_NOT_FOUNDを返します。

dwFlags RRF_SUBKEY_WOW6464KEY と RRF_SUBKEY_WOW6432KEYの両方の組み合わせを指定すると、ERROR_INVALID_PARAMETERが返されます。

備考

アプリケーションは通常、RegEnumValue を呼び出して値の名前を決定し、RegGetValue を して名前のデータを取得します。

データにREG_SZ、REG_MULTI_SZ、またはREG_EXPAND_SZ型があり、この関数の ANSI バージョンが使用されている場合 (RegGetValueA を明示的に呼び出すか、Windows.h ファイルを含める前に UNICODE を定義しない場合)、この関数は、格納されている Unicode 文字列を ANSI 文字列に変換してから、pvData指すバッファーにコピーします。

hkeyHKEY_PERFORMANCE_DATA ハンドルと指定したオブジェクトの値文字列に設定してこの関数を呼び出すと、返されるデータ構造に要求されないオブジェクトが含まれる場合があります。 驚かないでください。これは通常の動作です。 要求されたオブジェクトを検索するには、返されるデータ構造を常に確認する必要があります。

特定のレジストリ キーにアクセスする操作はリダイレクトされることに注意してください。 詳細については、「レジストリ仮想化 およびレジストリの 32 ビットおよび 64 ビット アプリケーション データを する」を参照してください。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNTを 0x0600 以降として定義します。 詳細については、「Windows ヘッダーの使用」を参照してください。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista、Windows XP Professional x64 Edition
サポートされる最小サーバー Windows Server 2008、Windows Server 2003 SP1
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winreg.h (Windows.h を含む)
ライブラリ Advapi32.lib
DLL Advapi32.dll

関連項目

RegCreateKeyEx の

RegEnumKeyEx を する

RegEnumValue を する

RegOpenKeyEx を する

RegQueryInfoKey の

レジストリ関数 を する

レジストリの概要