Función NtNotifyChangeMultipleKeys (winternl.h)
[Esta función se puede cambiar o quitar de Windows sin previo aviso. ]
Solicita notificación cuando cambia una clave del Registro o cualquiera de sus subclaves.
Sintaxis
__kernel_entry NTSTATUS NtNotifyChangeMultipleKeys(
[in] HANDLE MasterKeyHandle,
[in, optional] ULONG Count,
[in, optional] OBJECT_ATTRIBUTES [] SubordinateObjects,
[in, optional] HANDLE Event,
[in, optional] PIO_APC_ROUTINE ApcRoutine,
[in, optional] PVOID ApcContext,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[in] ULONG CompletionFilter,
[in] BOOLEAN WatchTree,
[out, optional] PVOID Buffer,
[in] ULONG BufferSize,
[in] BOOLEAN Asynchronous
);
Parámetros
[in] MasterKeyHandle
Identificador de una tecla abierta. El identificador debe abrirse con el derecho de acceso KEY_NOTIFY .
[in, optional] Count
Número de subclaves en la clave especificada por el parámetro MasterKeyHandle . Este parámetro debe ser 1.
[in, optional] SubordinateObjects
Puntero a una matriz de estructuras de OBJECT_ATTRIBUTES , una para cada subclave. Esta matriz puede contener una estructura OBJECT_ATTRIBUTES .
[in, optional] Event
Identificador de un evento creado por el autor de la llamada. Si Event no es NULL, el autor de la llamada espera hasta que la operación se realice correctamente, en cuyo momento se señala el evento.
[in, optional] ApcRoutine
Puntero a una función asincrónica de llamada a procedimiento (APC) proporcionada por el autor de la llamada. Si ApcRoutine no es NULL, la función de APC especificada se ejecuta una vez completada la operación.
[in, optional] ApcContext
Puntero a un contexto proporcionado por el autor de la llamada para su función de APC. Este valor se pasa a la función APC cuando se ejecuta. El parámetro asincrónico debe ser TRUE. Si se especifica ApcContext , el parámetro Event debe ser NULL.
[out] IoStatusBlock
Puntero a una estructura de IO_STATUS_BLOCK que contiene el estado final y la información sobre la operación. Para llamadas correctas que devuelven datos, el número de bytes escritos en el parámetro Buffer se proporciona en el miembro Information de la estructura IO_STATUS_BLOCK .
[in] CompletionFilter
Mapa de bits de las operaciones que desencadenan la notificación. Este parámetro puede ser una o varias de las marcas siguientes.
[in] WatchTree
Si este parámetro es TRUE, se notifica al autor de la llamada los cambios en todas las subclaves de la clave especificada. Si este parámetro es FALSE, el autor de la llamada solo recibe una notificación sobre los cambios realizados en la clave especificada.
[out, optional] Buffer
Reservado para uso del sistema. Este parámetro debe ser NULL.
[in] BufferSize
Reservado para uso del sistema. Este parámetro debe ser cero.
[in] Asynchronous
Si este parámetro es TRUE, la función devuelve inmediatamente. Si este parámetro es FALSE, la función no devuelve hasta que se produce el evento especificado.
Valor devuelto
Devuelve un NTSTATUS o un código de error.
Si el parámetro Asincrónico es TRUE y el evento especificado aún no se ha producido, la función devuelve STATUS_PENDING.
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 |