RxSetSrvCallDomainName 함수(rxprocs.h)
RxSetSrvCallDomainName 은 네트워크 미니 리디렉션기 드라이버에서 지정된 서버(SRV_CALL 구조)와 연결된 도메인 이름을 설정하기 위해 호출됩니다.
구문
NTSTATUS RxSetSrvCallDomainName(
[in] IN PMRX_SRV_CALL SrvCall,
[in] IN PUNICODE_STRING DomainName
);
매개 변수
[in] SrvCall
SRV_CALL 구조체에 대한 포인터입니다.
[in] DomainName
이 서버가 속한 도메인의 이름을 지정하는 0으로 끝나는 유니코드 문자열을 포함하는 버퍼에 대한 포인터입니다.
반환 값
RxSetSrvCallDomainName 은 성공 시 STATUS_SUCCESS 반환하거나 실패 시 다음 오류 값 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
이 루틴을 완료할 수 있는 리소스가 부족했습니다. 페이지가 없는 풀 메모리가 새 도메인 이름을 저장하기 위해 메모리 할당 요청이 실패했습니다. |
설명
네트워크 리디렉션자 요청이 시작될 때 도메인 이름을 알 수 없습니다. RxSetSrvCallDomainName 루틴을 사용하면 도메인 이름이 알려지면 SrvCall과 연결할 수 있습니다. 이 루틴은 일반적으로 SRV_CALL 구조의 생성 및 초기화의 일부로 사용됩니다.
도메인 이름이 이미 SrvCall 매개 변수와 연결된 경우 이 도메인 이름이 제거되고 SrvCall 에서 이 항목과 연결된 메모리가 해제됩니다.
DomainName 매개 변수가 NULL 포인터가 아니고 DomainName 매개 변수의 길이가 0보다 큰 경우 RxSetSrvCallDomainName은 RX_SRVCALL_PARAMS_POOLTAG 풀 태그가 있는 비페이지 풀에서 SrvCall의 pDomainName 멤버에 대한 공간을 할당합니다. RxSetSrvCallDomainName 루틴은 pDomainName 구조체의 버퍼, 길이 및 MaximumLength 멤버를 설정합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 데스크톱 |
머리글 | rxprocs.h(Mrxfcb.h, Rxprocs.h 포함) |
IRQL | <= APC_LEVEL |