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 반환하거나 실패 시 다음 오류 값 중 하나를 반환합니다.

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

설명

네트워크 리렉터 요청이 시작될 때 도메인 이름을 알 수 없습니다. RxSetSrvCallDomainName 루틴을 사용하면 도메인 이름이 알려지면 SrvCall에 연결할 수 있습니다. 이 루틴은 일반적으로 SRV_CALL 구조의 생성 및 초기화의 일부로 사용됩니다.

도메인 이름이 이미 SrvCall 매개 변수와 연결된 경우 이 도메인 이름이 제거되고 SrvCall 에서 이 항목과 연결된 메모리가 해제됩니다.

DomainName 매개 변수가 NULL 포인터가 아니고 DomainName 매개 변수의 길이가 0보다 큰 경우 RxSetSrvCallDomainName은 RX_SRVCALL_PARAMS_POOLTAG 풀 태그가 있는 비페이지 풀에서 SrvCallpDomainName 멤버에 대한 공간을 할당합니다. RxSetSrvCallDomainName 루틴은 pDomainName 구조체의 버퍼, 길이MaximumLength 멤버를 설정합니다.

요구 사항

   
대상 플랫폼 데스크톱
헤더 rxprocs.h(Mrxfcb.h, Rxprocs.h 포함)
IRQL <= APC_LEVEL

참고 항목

RxCreateSrvCall

RxFinalizeSrvCall