更新 : 2007 年 11 月
m_hKey の値フィールドのうち、指定された値フィールドのデータを取得します。以前のバージョンのこのメソッドはサポートされず、ATL_DEPRECATED のマークが付いています。
LONG QueryValue(
LPCTSTR pszValueName,
DWORD* pdwType,
void* pData,
ULONG* pnBytes
) throw( );
ATL_DEPRECATED LONG QueryValue(
DWORD& dwValue,
LPCTSTR lpszValueName
);
ATL_DEPRECATED LONG QueryValue(
LPTSTR szValue,
LPCTSTR lpszValueName,
DWORD* pdwCount
);
パラメータ
pszValueName
照会する値の名前を含む Null で終わる文字列を指すポインタ。pszValueName が NULL または空の文字列 "" である場合、キーに無名の値または既定の値があれば、その値について型とデータを取得します。pdwType
指定された値に格納されているデータの型を示すコードを受け取る変数へのポインタ。型コードが必要ない場合、パラメータ pdwType は NULL でもかまいません。pData
値のデータを受け取るバッファへのポインタ。データが必要ない場合、このパラメータは NULL でもかまいません。pnBytes
pData の指すバッファのサイズをバイト単位で指定する変数へのポインタ。メソッドが戻るとき、pData. にコピーされたデータのサイズが、この変数に格納されます。dwValue
値フィールドの数値データ。lpszValueName
クエリされる値フィールドを指定します。szValue
値フィールドの文字列データ。pdwCount
文字列データのサイズ。初期値は、バッファ szValue のサイズに設定されます。
戻り値
処理が正常に行われた場合は、ERROR_SUCCESS を返します。それ以外の場合は、WINERROR.H で定義された 0 以外のエラー コードを返します。
解説
QueryValue の元の 2 形式は現在ではサポートされておらず、ATL_DEPRECATED とマークされます。これらの形式が使われると、コンパイラは警告メッセージを表示します。
残りのメソッドは RegQueryValueEx を呼び出します。
.gif "セキュリティに関するメモ") セキュリティに関するメモ : |
|---|
呼び出し元では、このメソッドを使用してレジストリの場所を指定できますが、信頼性の低いデータが読み込まれる可能性があります。また、このメソッドが使用する RegQueryValueEx 関数は、NULL で終わる文字列を明示的に処理しません。これらの条件については、呼び出し元のコードで確認する必要があります。 |
必要条件
ヘッダー : atlbase.h