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