RegQueryInfoKeyW.3w

Langue: en

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

Section: 3 (Bibliothèques de fonctions)

NAME

RegQueryInfoKeyW (ADVAPI32.@)

SYNOPSIS

LSTATUS RegQueryInfoKeyW
 (
  HKEY      hkey,
  LPWSTR    class,
  LPDWORD   class_len,
  LPDWORD   reserved,
  LPDWORD   subkeys,
  LPDWORD   max_subkey,
  LPDWORD   max_class,
  LPDWORD   values,
  LPDWORD   max_value,
  LPDWORD   max_data,
  LPDWORD   security,
  FILETIME* modif
 )

DESCRIPTION

Retrieves information about the specified registry key.

PARAMS

hkey [In] Handle to key to query.

class [Out] Buffer for class string.

class_len [Out] Size of class string buffer.

reserved [In] Reserved.

subkeys [Out] Buffer for number of subkeys.

max_subkey [Out] Buffer for longest subkey name length.

max_class [Out] Buffer for longest class string length.

values [Out] Buffer for number of value entries.

max_value [Out] Buffer for longest value name length.

max_data [Out] Buffer for longest value data length.

security [Out] Buffer for security descriptor length.

modif [Out] Modification time.

RETURNS

Success: ERROR_SUCCESS

Failure: system error code.

NOTES

- win95 allows class to be valid and class_len to be NULL

- winnt returns ERROR_INVALID_PARAMETER if class is valid and class_len is NULL

- both allow class to be NULL and class_len to be NULL (it's hard to test validity, so test !NULL instead)

IMPLEMENTATION

Defined in "winreg.h".

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

Debug channel "reg".