RegCreateKeyExA.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

RegCreateKeyExA (ADVAPI32.@)

SYNOPSIS

LSTATUS RegCreateKeyExA
 (
  HKEY                 hkey,
  LPCSTR               name,
  DWORD                reserved,
  LPSTR                class,
  DWORD                options,
  REGSAM               access,
  SECURITY_ATTRIBUTES* sa,
  PHKEY                retkey,
  LPDWORD              dispos
 )

DESCRIPTION

Open a registry key, creating it if it doesn't exist.

PARAMS

hkey [In] Handle of the parent registry key.

name [In] Name of the new key to open or create.

reserved [In] Reserved, pass 0.

class [In] The object type of the new key.

options [In] Flags controlling the key creation (REG_OPTION_* flags from "winnt.h").

access [In] Access level desired.

sa [In] Security attributes for the key.

retkey [Out] Destination for the resulting handle.

dispos [Out] Receives REG_CREATED_NEW_KEY or REG_OPENED_EXISTING_KEY.

RETURNS

Success: ERROR_SUCCESS.

Failure: A standard Win32 error code. retkey remains untouched.

FIXME

MAXIMUM_ALLOWED in access mask not supported by server

IMPLEMENTATION

Defined in "winreg.h".

Implemented in "dlls/advapi32/registry.c".

Debug channel "reg".