(wdm.h) RtlWriteRegistryValue 函式
RtlWriteRegistryValue 例程會將呼叫端提供的數據寫入登錄中，並沿著指定值名稱的指定相對路徑。
語法
NTSYSAPI NTSTATUS RtlWriteRegistryValue(
[in] ULONG RelativeTo,
[in] PCWSTR Path,
[in] PCWSTR ValueName,
[in] ULONG ValueType,
[in, optional] PVOID ValueData,
[in] ULONG ValueLength
);
參數
[in] RelativeTo
指定 Path 是絕對登錄路徑，還是相對於預先定義的路徑，做為下列其中一項。
| 值 | 意義 |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Path 是絕對登錄路徑。 |
| RTL_REGISTRY_SERVICES | 路徑相對於 \Registry\Machine\System\CurrentControlSet\Services。 |
| RTL_REGISTRY_CONTROL | 路徑相對於 \Registry\Machine\System\CurrentControlSet\Control。 |
| RTL_REGISTRY_WINDOWS_NT | 路徑相對於 \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion。 |
| RTL_REGISTRY_DEVICEMAP | 路徑相對於 \Registry\Machine\Hardware\DeviceMap。 |
| RTL_REGISTRY_USER | 路徑相對於 \Registry\User\CurrentUser。 (針對系統程式，這是 \Users\。Default.) |
| RTL_REGISTRY_OPTIONAL | 指定此參數和 Path 參數所參考的索引鍵是選擇性的。 |
| RTL_REGISTRY_HANDLE | 指定 Path 參數實際上是要使用的登錄句柄。 這是選擇性的值。 |
[in] Path
絕對登錄路徑的指標，或 相對於 RelativeTo 參數所指定之已知位置的路徑。 如果指定了RTL_REGISTRY_HANDLE旗標，此參數就是直接使用已開啟密鑰的登錄句柄。
[in] ValueName
要寫入登錄之子機碼或值專案名稱的指標。
[in] ValueType
指定決定 ValueName 參數類型的 REG_XXX 值。 如需可能值的清單，請參閱 ZwSetValueKey 的 Type 參數。
[in, optional] ValueData
子機碼名稱的指標，或其值專案的名稱 (或兩者) 要寫入登錄中。
[in] ValueLength
指定要寫入登錄的 ValueData 位元組數目。
傳回值
RtlWriteRegistryValue 會傳回作業的狀態，STATUS_SUCCESS或錯誤狀態。
備註
如果指定的索引鍵不存在，例程會嘗試建立密鑰。 若要讓此嘗試成功，新密鑰必須是 Path 參數所參考密鑰的直接子機碼，且 Path 所參考的金鑰必須已開啟，才能存取KEY_CREATE_SUB_KEY。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |