RegCloseKey函數釋放給定鍵的句柄。
LONG RegCloseKey( HKEY hKey // 要關閉鍵的句柄);
參數
- hKey
- 要關閉已打開鍵的句柄。
返回值
如果調用成功,返回ERROR_SUCCESS。
如果調用失敗,返回非零錯誤代碼(定義在WINERROR.H)。你可以使用帶有FORMAT_MESSAGE_FROM_SYSTE標記 FormatMessage函數獲得普通錯誤描述信息。
注意
這個給定鍵的句柄不應該在它關閉后使用,因為它不再有效。鍵句柄不應該比需要的時間短。
RegCloseKey在返回之前不需要往注冊表中寫信息;它可以花費幾秒緩存到硬盤的緩存區。如果一個應用程序必須明確的寫注冊信息到硬盤,它可以使用RegFlushKey函數。RegFlushKey,然而使用了更多的系統資源,應該在必需時才調用它。
Windows CE: RegCloseKey函數總是在返回前寫信息到注冊表,在Windows CE去除了緩存鍵的需要。
快速信息
Windows NT: 需要3.1或更高版本。
Windows: 需要Windows 95或更高版本。
Windows CE: 需要1.0或更高版本。
頭文件: winreg.h。
輸入庫: advapi32.lib。