Функция RegisterManageableLogClient (clfsmgmtw32.h)

Функция RegisterManageableLogClient регистрирует клиент в диспетчере журналов. Клиент может указать, следует ли получать уведомления с помощью обратных вызовов или помещать уведомления в очередь для извлечения с помощью ReadLogNotification.

Синтаксис

CLFSUSER_API BOOL RegisterManageableLogClient(
  [in] HANDLE                    hLog,
  [in] PLOG_MANAGEMENT_CALLBACKS pCallbacks
);

Параметры

[in] hLog

Дескриптор регистрируемого журнала. Допускается только одна регистрация для каждого уникального открытия журнала.

[in] pCallbacks

Указывает обратные вызовы, для использования которыми регистрируется клиент. Допустимые обратные вызовы перечисляются LOG_MANAGEMENT_CALLBACKS. Вместо этого укажите ноль для отправки уведомлений в очередь.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Клиент может отменить регистрацию, закрыв дескриптор журнала или вызвав DeregisterManageableLogClient.

Примеры

Пример использования этой функции см. в разделе Создание файла журнала.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 R2 [только классические приложения]
Целевая платформа Windows
Header clfsmgmtw32.h
Библиотека Clfsw32.lib
DLL Clfsw32.dll

См. также раздел

DeregisterManageableLogClient

LOG_MANAGEMENT_CALLBACKS