RegGetValueW.3w

Langue: en

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

Section: 3 (Bibliothèques de fonctions)

NAME

RegGetValueW (ADVAPI32.@)

SYNOPSIS

LSTATUS RegGetValueW
 (
  HKEY    hKey,
  LPCWSTR pszSubKey,
  LPCWSTR pszValue,
  DWORD   dwFlags,
  LPDWORD pdwType,
  PVOID   pvData,
  LPDWORD pcbData
 )

DESCRIPTION

Retrieves the type and data for a value name associated with a key, optionally expanding its content and restricting its type.

PARAMS

hKey [In] Handle to an open key.

pszSubKey [In] Name of the subkey of hKey.

pszValue [In] Name of value under hKey/szSubKey to query.

dwFlags [In] Flags restricting the value type to retrieve.

pdwType [Out] Destination for the values type, may be NULL.

pvData [Out] Destination for the values content, may be NULL.

pcbData [In/Out] Size of pvData, updated with the size in bytes required to retrieve the whole content, including the trailing ' ' for strings.

RETURNS

Success: ERROR_SUCCESS

Failure: nonzero error code from Winerror.h.

NOTES

- Unless RRF_NOEXPAND is specified, REG_EXPAND_SZ values are automatically expanded and pdwType is set to REG_SZ instead.

- Restrictions are applied after expanding, using RRF_RT_REG_EXPAND_SZ without RRF_NOEXPAND is thus not allowed.

IMPLEMENTATION

Defined in "winreg.h".

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

Debug channel "reg".