Функция 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.

Замечания

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

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

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

Требования

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

См. также

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT

  • Last updated on