Export (0) Print
Expand All

ClfsMgmtRegisterManagedClient routine

The ClfsMgmtRegisterManagedClient routine creates a client that will manage a CLFS log.

Syntax


NTSTATUS ClfsMgmtRegisterManagedClient(
  _In_  PLOG_FILE_OBJECT               LogFile,
  _In_  PCLFS_MGMT_CLIENT_REGISTRATION RegistrationData,
  _Out_ PCLFS_MGMT_CLIENT              Client
);

Parameters

LogFile [in]

A pointer to a LOG_FILE_OBJECT structure that represents the CLFS log stream that the client created by ClfsMgmtRegisterManagedClient will manage.

RegistrationData [in]

An instance of the CLFS_MGMT_CLIENT_REGISTRATION structure that contains the functions that will be used to manage the log.

Client [out]

A pointer to the client.

Return value

The ClfsMgmtRegisterManagedClient routine returns one of the following NTSTATUS values:

Return codeDescription
STATUS_SUCCESS

A client has been created to manage the log.

STATUS_UNSUCCESSFUL

CLFS management was not able to create a client to manage the log.

STATUS_INSUFFICIENT_RESOURCES

There is insufficient memory to complete the operation.

STATUS_INVALID_PARAMETER

An input parameter is invalid.

 

This routine might also return other NTSTATUS Values.

Remarks

The Client parameter that is provided by the ClfsMgmtRegisterManagedClient routine is a required parameter for other CLFS management functions. You should store this value for later use.

A client application must be ready for its callback routine to be called as soon as it calls the ClfsMgmtRegisterManagedClient routine.

More than one client can register with a log stream.

Requirements

Target platform

Desktop

Version

Available in Windows Server 2003 R2, Windows Vista, and later versions of Windows.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Clfs.lib

DLL

Clfs.sys

IRQL

<= APC_LEVEL

See also

CLFS_MGMT_CLIENT_REGISTRATION
LOG_FILE_OBJECT

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft