RxCreateVNetRoot 함수(fcb.h)

아티클
02/26/2024

RxCreateVNetRoot 는 NET_ROOT 구조를 할당하고 초기화하고 연결된 디바이스 개체의 net name 테이블에 이름을 삽입합니다.

구문

PV_NET_ROOT RxCreateVNetRoot(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PNET_ROOT         NetRoot,
  [in] IN PUNICODE_STRING   CanonicalName,
  [in] IN PUNICODE_STRING   LocalNetRootName,
  [in] IN PUNICODE_STRING   FilePath,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

매개 변수

[in] RxContext

만들기 작업을 설명하는 IRP가 포함된 RDBSS RX_CONTEXT 대한 포인터입니다.

[in] NetRoot

연결된 NET_ROOT 구조체에 대한 포인터입니다.

[in] CanonicalName

이름 테이블에 삽입할 정식 이름에 대한 포인터입니다.

[in] LocalNetRootName

접두사 이름이 없는 로컬 NET_ROOT 이름에 대한 포인터입니다.

[in] FilePath

파일 경로 이름에 대한 포인터입니다. 이 매개 변수는 현재 사용되지 않으며 NULL일 수 있습니다.

[in] RxConnectionId

접두사 이름 테이블에 삽입할 이름과 연결할 연결 ID에 대한 포인터입니다. 이 매개 변수는 NULL 일 수 있으며 이 경우 이름 테이블에 삽입된 이름과 연결 ID가 연결되지 않습니다.

반환 값

RxCreateVNetRoot 는 성공 시 새로 만든 V_NET_ROOT 데이터 구조에 대한 포인터 또는 실패 시 NULL 포인터를 반환합니다.

설명

RxCreateVNetRoot 루틴은 일반적으로 네트워크 미니 리디렉터 드라이버에서 직접 호출되지 않습니다. RDBSS는 IRP_MJ_CREATE 대한 I/O 요청 패킷이 수신되고 V_NET_ROOT 만들어야 할 때 내부적으로 이 루틴을 호출합니다. 이 IRP는 일반적으로 네트워크 공유에서 파일 만들기 작업을 요청하는 사용자 모드 애플리케이션에 대한 응답으로 RDBSS에서 수신됩니다. 다른 커널 드라이버가 이러한 IRP를 발급할 수도 있습니다.

RxCreateVNetRoot를 호출하기 전에 RxContext 매개 변수의 디바이스 개체 멤버와 연결된 이름 테이블에 대한 잠금을 단독 모드로 획득해야 합니다.

RxCreateVNetRoot 는 RX_CONTEXT 매개 변수를 기반으로 V_NET_ROOT 구조에서 다양한 보안 컨텍스트 매개 변수를 설정합니다. 이러한 매개 변수에는 LogonId, SessionId, pUserName, pUserDomainName, pPassword 및 Flags가 포함 됩니다.