CRegKey::QueryValue

  • 發行項

呼叫這個方法會擷取資料。 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
    out 包含值的名稱是以 null 結尾字串的指標查詢。如果 pszValueName 為 null 或空字串， ""，方法會擷取型別和資料為未命名的索引鍵或預設值，，如果有的話。

  • pdwType
    out 接收表示中資料的型別程式碼之變數的指標儲存時所指定的值。如果不需要， pdwType 參數可以是 null 輸入密碼。

  • pData
    out 接收值之資料的緩衝區指標。如果不需要，這個參數可以是 null 資料。

  • pnBytes
    以位元組為單位)，指定緩衝區大小，變數的指標所指向的 pData 參數。當方法傳回時，這個變數包含資料的大小會複製到 pData。

  • dwValue
    欄位值的數值資料。

  • lpszValueName
    指定要查詢的值欄位。

  • szValue
    值欄位中的字串資料。

  • pdwCount
    字串資料的大小。其值一開始是設定為 szValue 緩衝區的大小。

傳回值

如果成功，則傳回 ERROR_SUCCESS;否則，在 WINERROR.H. 定義的非零的錯誤碼。

備註

QueryValue 兩個內部原始版本不再支援和標記為 ATL_DEPRECATED。編譯器會發出警告是否使用這些表單。

剩餘的方法呼叫 RegQueryValueEx。

安全性注意事項安全性提示

這個方法允許呼叫端指定所有登錄位置，可能會無法信任的資料。此外，使用的 RegQueryValueEx 函式明確使用這個方法會處理是 NULL 結束的字串。應該檢查兩個條件由呼叫程式碼。

需求

Header: atlbase.h

請參閱

參考

CRegKey 類別

CRegKey::SetValue

Registry Value Types