RxSetDomainForMailslotBroadcast 함수(mrx.h)

아티클
10/13/2023

RxSetDomainForMailslotBroadcast 는 네트워크 미니 리디렉션기 드라이버에서 호출되어 드라이버에서 mailslot을 지원하는 경우 mailslot 브로드캐스트에 사용되는 도메인을 설정합니다.

구문

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

매개 변수

[in] DomainName

mailslots에 사용할 도메인 이름을 지정하는 0으로 끝나는 유니코드 문자열이 포함된 버퍼에 대한 포인터입니다.

반환 값

RxSetDomainForMailslotBroadcast 는 성공 시 STATUS_SUCCESS 반환하거나 실패 시 다음 오류 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_INSUFFICIENT_RESOURCES	이 루틴을 완료할 수 있는 리소스가 부족했습니다. 페이지가 지정되지 않은 풀 메모리가 도메인 이름을 저장하기 위해 메모리 할당 요청이 실패했습니다.

설명

네트워크 미니 리디렉션기는 드라이버가 커널에 의해 로드될 때마다 RDBSS에 등록되고 드라이버가 언로드될 때 RDBSS를 사용하여 등록을 취소합니다. 이 등록 프로세스는 네트워크 미니 리디렉터가 RDBSS에서 내보낸 등록 루틴인 RxRegisterMinirdr를 호출하여 로드되었음을 RDBSS에 알리는 양방향 핸드 쉐이크입니다. RDBSS는 네트워크 미니 리디렉터에서 내보내고 디스패치 테이블의 일부로 RxRegisterMinirdr에 전달된 콜백 루틴 중 하나인 MrxStart를 호출하여 등록 및 초기화 프로세스를 완료합니다.

RxRegisterMinirdr 루틴에 전달된 매개 변수 중 하나는 네트워크 미니 리디렉터가 mailslot을 지원하는지 여부를 나타냅니다. 네트워크 미니 리디렉터에서는 일반적으로 MrxStart 루틴 또는 외부 요청의 일부로 RxSetDomainForMailslotBroadcast를 호출하여 사용자 모드 애플리케이션 또는 서비스에서 파일 시스템 컨트롤(FSCTRL) 또는 I/O 컨트롤(IOCTL) 요청에 의해 시작된 드라이버를 시작합니다.