Funzione RtlCreateRegistryKey (wdm.h)

Articolo
02/29/2024

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