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

ClfsMgmtRegisterManagedClient에서 만든 클라이언트가 관리할 CLFS 로그 스트림을 나타내는 LOG_FILE_OBJECT 구조체에 대한 포인터입니다.

[in] RegistrationData

로그를 관리하는 데 사용할 함수를 포함하는 CLFS_MGMT_CLIENT_REGISTRATION 구조체의 instance.

ClientCookie

나중에 API를 사용하기 위해 호출자에게 제공하는 쿠키입니다.

반환 값

ClfsMgmtRegisterManagedClient 루틴은 다음 NTSTATUS 값 중 하나를 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 로그를 관리하기 위해 클라이언트가 만들어졌습니다.
STATUS_UNSUCCESSFUL
 CLFS 관리에서 로그를 관리하는 클라이언트를 만들 수 없습니다.
STATUS_INSUFFICIENT_RESOURCES
 메모리가 부족하여 작업을 완료할 수 없습니다.
STATUS_INVALID_PARAMETER
 입력 매개 변수가 잘못되었습니다.
 

이 루틴은 다른 NTSTATUS 값을 반환할 수도 있습니다.

설명

ClfsMgmtRegisterManagedClient 루틴에서 제공하는 Client 매개 변수는 다른 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