estrutura OB_OPERATION_REGISTRATION (wdm.h)

Artigo
02/29/2024

A estrutura OB_OPERATION_REGISTRATION especifica as rotinas de retorno de chamada ObjectPreCallback e ObjectPostCallback e os tipos de operações para as quais as rotinas são chamadas.

Sintaxe

typedef struct _OB_OPERATION_REGISTRATION {
  POBJECT_TYPE                *ObjectType;
  OB_OPERATION                Operations;
  POB_PRE_OPERATION_CALLBACK  PreOperation;
  POB_POST_OPERATION_CALLBACK PostOperation;
} OB_OPERATION_REGISTRATION, *POB_OPERATION_REGISTRATION;

Membros

ObjectType

Um ponteiro para o tipo de objeto que dispara a rotina de retorno de chamada. Especifique um dos seguintes valores:

PsProcessType para operações de identificador de processo
PsThreadType para operações de identificador de thread
ExDesktopObjectType para operações de identificador de área de trabalho. Esse valor tem suporte em Windows 10 e não nas versões anteriores do sistema operacional.

Operations

Especifique um ou mais dos seguintes sinalizadores:

OB_OPERATION_HANDLE_CREATE

Um novo processo, thread ou identificador de área de trabalho foi ou será aberto.

OB_OPERATION_HANDLE_DUPLICATE

Um processo, thread ou identificador de área de trabalho foi ou será duplicado.

PreOperation

Um ponteiro para uma rotina ObjectPreCallback . O sistema chama essa rotina antes que a operação solicitada ocorra.

PostOperation

Um ponteiro para uma rotina ObjectPostCallback . O sistema chama essa rotina após a operação solicitada.

Comentários

Essa estrutura é usada pela rotina ObRegisterCallbacks . O parâmetro CallBackRegistration para essa rotina é um ponteiro para um buffer que contém uma estrutura OB_CALLBACK_REGISTRATION seguida por uma matriz de uma ou mais estruturas OB_OPERATION_REGISTRATION .

Em cada estrutura OB_OPERATION_REGISTRATION passada para ObRegisterCallback, o chamador deve fornecer uma ou ambas as rotinas de retorno de chamada. Se os membros PreOperation e PostOperation dessa estrutura forem NULL, a operação de registro de retorno de chamada falhará.