Функция ClfsMgmtRegisterManagedClient (wdm.h)

  • Статья

Подпрограмма ClfsMgmtRegisterManagedClient создает клиент, который будет управлять журналом CLFS.

Синтаксис

CLFSUSER_API NTSTATUS ClfsMgmtRegisterManagedClient(
  [in] PLOG_FILE_OBJECT               LogFile,
  [in] PCLFS_MGMT_CLIENT_REGISTRATION RegistrationData,
       PCLFS_MGMT_CLIENT              ClientCookie
);

Параметры

[in] LogFile

Указатель на структуру LOG_FILE_OBJECT , представляющую поток журнала CLFS, которым будет управлять клиент , созданный ClfsMgmtRegisterManagedClient .

[in] RegistrationData

Экземпляр структуры CLFS_MGMT_CLIENT_REGISTRATION , содержащей функции, которые будут использоваться для управления журналом.

ClientCookie

Файл cookie, который мы возвращаем вызывающему объекту для использования API в будущем.

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

Подпрограмма ClfsMgmtRegisterManagedClient возвращает одно из следующих значений NTSTATUS:

Код возврата Описание
STATUS_SUCCESS
 Для управления журналом создан клиент.
STATUS_UNSUCCESSFUL
 Системе управления CLFS не удалось создать клиент для управления журналом.
STATUS_INSUFFICIENT_RESOURCES
 Недостаточно памяти для завершения операции.
STATUS_INVALID_PARAMETER
 Входной параметр недопустим.
 

Эта подпрограмма также может возвращать другие значения NTSTATUS.

Комментарии

Параметр Client , предоставляемый подпрограммой ClfsMgmtRegisterManagedClient , является обязательным параметром для других функций управления CLFS. Это значение следует сохранить для последующего использования.

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

В потоке журналов может быть зарегистрировано несколько клиентов.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

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

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT