RxpTrackReference 함수(fcb.h)

아티클
10/10/2023

RxpTrackReference 는 확인된 빌드에서 SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB 및 SRV_OPEN 구조를 참조하는 요청을 추적합니다. 이러한 참조 요청의 로그는 로깅 시스템 및 WMI에서 액세스할 수 있습니다.

구문

void RxpTrackReference(
  ULONG TraceType,
  PCSTR FileName,
  ULONG Line,
  PVOID Instance
);

매개 변수

TraceType

[in] 추적할 참조 요청 유형을 결정하는 값입니다. 이 값은 fcb.h에 정의된 다음 매크로 중 하나일 수 있습니다.

값	의미
RDBSS_REF_TRACK_SRVCALL	SRV_CALL 구조체에 대한 참조 요청입니다.
RDBSS_REF_TRACK_NETROOT	NET_ROOT 구조체에 대한 참조 요청입니다.
RDBSS_REF_TRACK_VNETROOT	V_NET_ROOT 구조체에 대한 참조 요청입니다.
RDBSS_REF_TRACK_NETFOBX	FOBX 구조체에 대한 참조 요청입니다.
RDBSS_REF_TRACK_NETFCB	FCB 구조체에 대한 참조 요청입니다.
RDBSS_REF_TRACK_SRVOPEN	SRV_OPEN 구조체에 대한 참조 요청입니다.

FileName

[in] 이 루틴이 호출된 원본 파일의 이름입니다.

Line

[in] 이 루틴이 호출된 원본 파일의 줄 번호입니다.

Instance

참조할 구조체에 대한 포인터입니다.

반환 값

없음

설명

확인된 빌드에서 RxpTrackReference 는 SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB 및 SRV_OPEN 구조를 참조하는 요청을 추적하는 데 사용됩니다. 소매 빌드의 경우 이 함수는 아무 것도 수행하지 않습니다.

WMI를 사용하도록 설정하면 이러한 역참조 작업의 로그가 알림을 요청한 사용자 모드 WMI 구성 요소에 WMI 이벤트로 전송됩니다. 로깅을 사용하는 경우 지연 요청은 _RxLog 루틴을 호출하여 I/O 오류 로그 항목을 기록하여 RDBSS 로깅 시스템에 기록됩니다.

이 루틴은 실제로 전달된 구조체를 참조하지 않습니다(구조체에 대한 참조 횟수 증가).

이 루틴을 호출하는 기본 방법인 디버깅을 위해 fcb.h 에 많은 매크로가 정의되어 있습니다. 이러한 매크로는 SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB 및 SRV_OPEN 구조에 대한 파일 구조 관리 작업에 사용되는 RxReference 또는 RxDereference 루틴에 대한 래퍼를 제공합니다. 이러한 매크로는 먼저 해당 RxpTrackReference 루틴을 호출하여 해당 RxReference 루틴을 호출하기 전에 요청에 대한 진단 정보를 기록합니다.

소매 빌드의 경우 이 함수는 아무 것도 수행하지 않습니다.