CRegKey 類別

這個類別會提供對作業系統中登錄的輸入的方法。

重要事項重要事項

這個類別和其成員不能用於 Windows 執行階段執行的應用程式。

class CRegKey

Members

xka57xy4.collapse_all(zh-tw,VS.110).gif公用建構函式

名稱

描述

CRegKey::CRegKey

建構函式。

CRegKey::~CRegKey

解構函式。

xka57xy4.collapse_all(zh-tw,VS.110).gif公用方法

名稱

描述

CRegKey::Attach

呼叫這個方法要附加至 CRegKey 物件可透過將 m_hKey 成員的控制代碼。 hKey。

CRegKey::Close

呼叫這個方法會釋放 m_hKey 成員控制代碼並將其設為 null。

CRegKey::Create

如果不存在則為, hKeyParent子機碼呼叫這個方法會為指定的索引鍵。

CRegKey::DeleteSubKey

呼叫這個方法會從登錄中移除指定的索引鍵。

CRegKey::DeleteValue

呼叫這個方法會從移除 m_hKey值欄位。

CRegKey::Detach

呼叫這個方法中斷連結 CRegKey 物件的 m_hKey 成員控制代碼和集合 m_hKey 為 NULL。

CRegKey::EnumKey

呼叫這個方法會列舉開啟登錄機碼的子機碼。

CRegKey::Flush

呼叫這個方法可將所有開啟登錄機碼的屬性寫入登錄中。

CRegKey::GetKeySecurity

呼叫這個方法會擷取保護開啟登錄機碼的安全性描述元的複本。

CRegKey::NotifyChangeKeyValue

這個方法會告知變更呼叫端存取開啟登錄機碼的屬性或內容。

CRegKey::Open

呼叫這個方法會開啟指定的索引鍵和 m_hKey 集合加入至這個金鑰控制代碼。

CRegKey::QueryBinaryValue

呼叫這個方法會擷取某個值名稱的二進位資料。

CRegKey::QueryDWORDValue

呼叫這個方法會擷取 DWORD 資料為指定的值名稱。

CRegKey::QueryGUIDValue

呼叫這個方法會擷取 GUID 資料為指定的值名稱。

CRegKey::QueryMultiStringValue

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

CRegKey::QueryQWORDValue

呼叫這個方法會擷取 QWORD 資料為指定的值名稱。

CRegKey::QueryStringValue

呼叫這個方法會擷取資料行的資料。指定名稱。

CRegKey::QueryValue

呼叫這個方法會擷取資料。 m_hKey指定欄位。這個方法舊版不再支援和標記為 ATL_DEPRECATED

CRegKey::RecurseDeleteKey

呼叫這個方法會從登錄中移除指定的索引鍵和明確移除所有子機碼。

CRegKey::SetBinaryValue

呼叫這個方法會設定登錄機碼的二進位值。

CRegKey::SetDWORDValue

呼叫這個方法會設定登錄機碼的 DWORD 值。

CRegKey::SetGUIDValue

呼叫這個方法會設定登錄機碼的 GUID 值。

CRegKey::SetKeySecurity

呼叫這個方法會設定登錄機碼的安全性。

CRegKey::SetKeyValue

呼叫這個方法會在指定的指定索引鍵欄位儲存資料。

CRegKey::SetMultiStringValue

呼叫這個方法會設定登錄機碼的 multistring 的值。

CRegKey::SetQWORDValue

呼叫這個方法會設定登錄機碼的 QWORD 值。

CRegKey::SetStringValue

呼叫這個方法會設定登錄機碼的字串值。

CRegKey::SetValue

呼叫這個方法會在指定的 m_hKey欄位來儲存資料。這個方法舊版不再支援和標記為 ATL_DEPRECATED

xka57xy4.collapse_all(zh-tw,VS.110).gif公用運算子

名稱

描述

CRegKey::operator HKEY

要轉換成的 CRegKey 物件。

CRegKey::operator =

指派運算子。

xka57xy4.collapse_all(zh-tw,VS.110).gif公用資料成員

名稱

描述

CRegKey::m_hKey

包含登錄機碼的控制代碼與 CRegKey 物件。

CRegKey::m_pTM

CAtlTransactionManager 物件的指標。

備註

CRegKey 提供建立和刪除機碼和值提供方法在系統登錄。註冊包含安裝特定一組系統元件的定義,例如軟體版本號碼、安裝的硬體邏輯與實體對應和 COM 物件。

CRegKey 提供程式設計介面寫入系統登錄指定的電腦。例如,開啟特定登錄機碼,呼叫 CRegKey::Open。擷取或修改資料值、呼叫 CRegKey::QueryValueCRegKey::SetValue,名稱分別為、和。若要關閉機碼,請呼叫 CRegKey::Close

在您關閉機碼時,它的登錄資料寫入硬碟時寫入 (清除)。這個程序可能需要幾秒鐘。如果您的應用程式必須寫入硬碟時明確寫入登錄資料,您可以呼叫 RegFlushKey Win32 函式。不過, RegFlushKey 使用許多系統資源,且應呼叫,只在絕對需要。

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

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

需求

Header: atlbase.h

請參閱

參考

Registry Overview

Registry Functions

Registry Value Types

概念

DCOM 範例

其他資源

ATL 類別概觀