Función ORQueryInfoKey

Recupera información sobre la clave del Registro especificada en un subárbol del Registro sin conexión.

Sintaxis

DWORD ORQueryInfoKey(
  _In_        ORHKEY    Handle,
  _Out_opt_   PWSTR     lpClass,
  _Inout_opt_ PDWORD    lpcClass,
  _Out_opt_   PDWORD    lpcSubKeys,
  _Out_opt_   PDWORD    lpcMaxSubKeyLen,
  _Out_opt_   PDWORD    lpcMaxClassLen,
  _Out_opt_   PDWORD    lpcValues,
  _Out_opt_   PDWORD    lpcMaxValueNameLen,
  _Out_opt_   PDWORD    lpcMaxValueLen,
  _Out_opt_   PDWORD    lpcbSecurityDescriptor,
  _Out_opt_   PFILETIME lpftLastWriteTime
);

Parámetros

Identificador [in]

Identificador de una clave del Registro abierta en un subárbol del registro sin conexión.

lpClass [out, optional]

Puntero a un búfer que recibe la clase de clave. Este parámetro puede ser NULL.

lpcClass [in, out, optional]

Puntero a una variable que especifica el tamaño del búfer al que apunta el parámetro lpClass , en caracteres.

El tamaño debe incluir el carácter nulo de terminación. Cuando se devuelve la función, esta variable contiene el tamaño de la cadena de clase que se almacena en el búfer. El recuento devuelto no incluye el carácter nulo de terminación. Si el búfer no es lo suficientemente grande, la función devuelve ERROR_MORE_DATA y la variable contiene el tamaño de la cadena, en caracteres, sin contar el carácter nulo de terminación.

Si lpClass es NULL, lpcClass puede ser NULL.

Si el parámetro lpClass es una dirección válida, pero el parámetro lpcClass no es (por ejemplo, si el parámetro lpcClass es NULL), la función devuelve ERROR_INVALID_PARAMETER.

lpcSubKeys [out, optional]

Puntero a una variable que recibe el número de subclaves que contiene la clave especificada. Este parámetro puede ser NULL.

lpcMaxSubKeyLen [out, optional]

Puntero a una variable que recibe el tamaño de la subclave de la clave con el nombre más largo, en caracteres Unicode, sin incluir el carácter nulo de terminación. Este parámetro puede ser NULL.

lpcMaxClassLen [out, opcional]

Puntero a una variable que recibe el tamaño de la cadena más larga que especifica una clase de subclave, en caracteres Unicode. El recuento devuelto no incluye el carácter nulo de terminación. Este parámetro puede ser NULL.

lpcValues [out, optional]

Puntero a una variable que recibe el número de valores asociados a la clave. Este parámetro puede ser NULL.

lpcMaxValueNameLen [out, opcional]

Puntero a una variable que recibe el tamaño del nombre de valor más largo de la clave, en caracteres Unicode. El tamaño no incluye el carácter nulo de terminación. Este parámetro puede ser NULL.

lpcMaxValueLen [out, opcional]

Puntero a una variable que recibe el tamaño del componente de datos más largo entre los valores de la clave, en bytes. Este parámetro puede ser NULL.

lpcbSecurityDescriptor [out, optional]

Puntero a una variable que recibe el tamaño del descriptor de seguridad de la clave, en bytes. Este parámetro puede ser NULL.

lpftLastWriteTime [out, optional]

Puntero a una estructura FILETIME que recibe la última hora de escritura. Este parámetro puede ser NULL.

La función establece los miembros de la estructura FILETIME para indicar la última vez que se modifica la clave o cualquiera de sus entradas de valor.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si la función no se ejecuta correctamente, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error.

Si el búfer lpClass es demasiado pequeño para recibir el nombre de la clase, la función devuelve ERROR_MORE_DATA.

Requisitos

Consulte también

FILETIME

ORCreateKey

OROpenKey

ORDeleteKey