CRegKey::QueryMultiStringValue

呼叫這個方法會擷取 multistring 資料的值名稱。

LONG QueryMultiStringValue(
   LPCTSTR pszValueName,
   LPTSTR pszValue,
   ULONG* pnChars 
) throw( );

參數

pszValueName
out 包含值的名稱是以 null 結尾字串的指標查詢。
pszValue
out 接收 multistring 之資料的緩衝區指標。multistring 是 null 結尾字串的陣列，由兩個 null 結束字元。
pnChars
大小，以 TCHARs，緩衝區所指向的 pszValue。當方法傳回時， pnChars 在 TCHARs， multistring 包含大小，擷取，包含結束的 null 字元。

如果方法成功，則傳回 ERROR_SUCCESS。如果方法無法讀取的值，則傳回此 WINERROR.H. 定義的非零的錯誤碼。如果參考的資料型別不是， ERROR_INVALID_DATA REG_MULTI_SZ 傳回。

這個方法使用 RegQueryValueEx 並檢查正確的資料型別傳回。如需的詳細資訊請參閱 RegQueryValueEx 。

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