Funzione RtlCreateRegistryKey (wdm.h)
La routine RtlCreateRegistryKey aggiunge un oggetto chiave nel Registro di sistema lungo un percorso relativo specificato.
Sintassi
NTSYSAPI NTSTATUS RtlCreateRegistryKey(
[in] ULONG RelativeTo,
[in] PWSTR Path
);
Parametri
[in] RelativeTo
Specifica se Path è un percorso del Registro di sistema assoluto o è relativo a un percorso di chiave predefinito come uno dei seguenti.
| Valore | Significato |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Percorso è un percorso del Registro di sistema assoluto. |
| RTL_REGISTRY_SERVICES | Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Services. |
| RTL_REGISTRY_CONTROL | Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Control. |
| RTL_REGISTRY_WINDOWS_NT | Il percorso è relativo a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion. |
| RTL_REGISTRY_DEVICEMAP | Il percorso è relativo a \Registry\Machine\Hardware\DeviceMap. |
| RTL_REGISTRY_USER | Il percorso è relativo a \Registry\User\CurrentUser. Per un processo di sistema, questo è \Users\. Impostazione predefinita. |
[in] Path
Specifica il percorso del Registro di sistema in base al valore RelativeTo .
Valore restituito
RtlCreateRegistryKey restituisce STATUS_SUCCESS se la chiave viene creata.
Commenti
RtlCreateRegistryKey crea solo le chiavi specificate. Non crea chiavi mancanti nel percorso della chiave specificata. Se mancano chiavi nel percorso, la chiamata avrà esito negativo. Per assicurarsi che esistano tutte le chiavi nel percorso, è necessario chiamare RtlCreateRegistryKey una volta per ogni chiave nel percorso.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |