CRegKey 類別

發行項
02/28/2013

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

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

class CRegKey

Members

公用建構函式

名稱	描述
CRegKey::CRegKey	建構函式。
CRegKey::~CRegKey	解構函式。

公用方法

名稱	描述
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。

公用運算子

名稱	描述
CRegKey::operator HKEY	要轉換成的 CRegKey 物件。
CRegKey::operator =	指派運算子。

公用資料成員

名稱	描述
CRegKey::m_hKey	包含登錄機碼的控制代碼與 CRegKey 物件。
CRegKey::m_pTM	為 CAtlTransactionManager 物件的指標。

備註

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

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

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

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

需求

Header: atlbase.h

請參閱

共用方式為