Compartir a través de


Función NtQueryMultipleValueKey (winternl.h)

[Esta función se puede cambiar o quitar de Windows sin previo aviso.]

Recupera los valores de la clave de varios valores especificada.

Sintaxis

__kernel_entry NTSTATUS NtQueryMultipleValueKey(
  [in]            HANDLE           KeyHandle,
  [in, out]       PKEY_VALUE_ENTRY ValueEntries,
  [in]            ULONG            EntryCount,
  [out]           PVOID            ValueBuffer,
  [in, out]       PULONG           BufferLength,
  [out, optional] PULONG           RequiredBufferLength
);

Parámetros

[in] KeyHandle

Identificador de la clave para la que se van a recuperar valores. El identificador debe abrirse con el derecho de acceso KEY_QUERY_VALUE .

[in, out] ValueEntries

Puntero a una matriz de estructuras [KEY_VALUE_ENTRY] que contienen los nombres de los valores que se van a recuperar.

[in] EntryCount

Número de elementos de la matriz ValueEntries .

[out] ValueBuffer

Puntero a un búfer para recibir los valores.

[in, out] BufferLength

Puntero a una variable que contiene el tamaño del búfer en ValueBuffer, en bytes. Cuando la función devuelve, el parámetro BufferLength contiene el número de bytes escritos en el búfer en ValueBuffer.

[out, optional] RequiredBufferLength

Puntero a una variable para recibir el número de bytes necesarios para que la función devuelva todos los valores. Este parámetro puede ser NULL.

Valor devuelto

Devuelve un NTSTATUS o un código de error.

Si el búfer es demasiado pequeño para contener la información que se va a recuperar, la función devuelve STATUS_BUFFER_OVERFLOW y, si se especifica el parámetro RequiredBufferLength , lo establece en el tamaño del búfer necesario.

Los formularios y la importancia de los códigos de error NTSTATUS se enumeran en el archivo de encabezado Ntstatus.h disponible en WDK y se describen en la documentación de WDK.

Comentarios

Esta función no tiene ningún archivo de encabezado asociado. También puede usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Ntdll.dll.

Requisitos

   
Plataforma de destino Windows
Encabezado winternl.h
Library ntdll.lib
Archivo DLL ntdll.dll

Consulte también

Derechos de acceso y seguridad de clave del Registro