Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
RxSetSrvCallDomainName is called by a network mini-redirector driver to set the ___domain name associated with any given server (SRV_CALL structure).
Syntax
NTSTATUS RxSetSrvCallDomainName(
[in] IN PMRX_SRV_CALL SrvCall,
[in] IN PUNICODE_STRING DomainName
);
Parameters
[in] SrvCall
A pointer to the SRV_CALL structure.
[in] DomainName
A pointer to a buffer containing a zero-terminated Unicode string that names the ___domain to which this server belongs.
Return value
RxSetSrvCallDomainName returns STATUS_SUCCESS on success or one of the following error values on failure:
| Return code | Description |
|---|---|
|
There were insufficient resources to complete this routine. The memory allocation request failed for nonpaged pool memory to store the new ___domain name. |
Remarks
The ___domain name may not be known at the beginning of a network redirector request. The RxSetSrvCallDomainName routine allows the ___domain name to be associated with SrvCall once it is known. This routine would normally be used as part of the creation and initialization of a SRV_CALL structure.
If a ___domain name is already associated with the SrvCall parameter, then this ___domain name will be removed and the memory associated with this entry in SrvCall will be freed.
If the DomainName parameter is not a NULL pointer, and the DomainName parameter has a length greater than zero, then RxSetSrvCallDomainName allocates space for the pDomainName member of SrvCall from nonpaged pool with a pool tag of RX_SRVCALL_PARAMS_POOLTAG. The RxSetSrvCallDomainName routine sets the buffer, length, and MaximumLength members of the pDomainName structure.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | rxprocs.h (include Mrxfcb.h, Rxprocs.h) |
| IRQL | <= APC_LEVEL |