Método GetRegistryValue

Prototipo

GetRegistryValue Proto hKey:HKEY, lpszSubKey:LPSTR, lpszValueName:LPSTR, lpszValue:LPSTR

Sintaxis

Invoke GetRegistryValue, hKey, lpszSubKey, lpszValueName, lpszValue

Función

Obtiene el contenido del nombre de valor indicado de la subclave indicada del registro de Windows.

Parámetros

hKey

"Handle" de una de las siguientes claves predefinidas:

ecClassesRoot
ecCurrentUser
ecLocalMachine
ecUsers
ecPerformanceData
ecCurrentConfig
ecDynData

lpszSubKey

Puntero a la dirección efectiva de una cadena acabada en cero con el nombre completo de la subclave que contiene el valor cuyo contenido se quiere obtener.

lpszValueName

Puntero a la dirección efectiva de una cadena acabada en cero con el nombre del valor cuyo contenido se quiere obtener.

lpszValue

Puntero a la dirección efectiva de una cadena acabada en cero que recibirá el contenido del nombre de valor.

Valor de retorno

Eax devuelve TRUE si se ha podido obtener el valor, o FALSE si no.

OBSERVACIONES: El parámetro lpszValue apunta a una cadena acabada en cero que recibirá el valor obtenido. Puede llenar esta cadena con el valor por defecto antes de llamar a este método, ya que éste será el valor que se devolverá si no se encuentra el nombre de valor indicado.

OBSERVACIONES: El método GetRegistryValue espera que lpszSubKey y lpszValueName sean cadenas Unicode y llena lpszValue con un valor Unicode si la aplicación se está ejecutando como Unicode. Si no, espera que lpszSubKey y lpszValueName sean cadenas ANSI y llena lpszValue con un valor ANSI (vea el método IsAppUnicode). Puede utilizar GetRegistryValueA para obtener valores ANSI en aplicaciones Unicode, o GetRegistryValueW para obtener valores Unicode en aplicaciones ANSI.

IMPORTANTE: La cadena apuntada por lpszValue debe poder contener hasta MAX_PATH caracteres.