Funzione RxSetSrvCallDomainName (rxprocs.h)
RxSetSrvCallDomainName viene chiamato da un driver mini-redirector di rete per impostare il nome di dominio associato a un determinato server (struttura SRV_CALL).
Sintassi
NTSTATUS RxSetSrvCallDomainName(
[in] IN PMRX_SRV_CALL SrvCall,
[in] IN PUNICODE_STRING DomainName
);
Parametri
[in] SrvCall
Puntatore alla struttura SRV_CALL.
[in] DomainName
Puntatore a un buffer contenente una stringa Unicode con terminazione zero che assegna un nome al dominio a cui appartiene il server.
Valore restituito
RxSetSrvCallDomainName restituisce STATUS_SUCCESS in caso di esito positivo o uno dei valori di errore seguenti in caso di errore:
Codice restituito | Descrizione |
---|---|
|
Non sono state eseguite risorse sufficienti per completare questa routine. La richiesta di allocazione della memoria non è riuscita per la memoria del pool non di paging per archiviare il nuovo nome di dominio. |
Commenti
Il nome di dominio potrebbe non essere noto all'inizio di una richiesta del redirector di rete. La routine RxSetSrvCallDomainName consente di associare il nome di dominio a SrvCall una volta che è noto. Questa routine viene in genere utilizzata come parte della creazione e dell'inizializzazione di una struttura SRV_CALL.
Se un nome di dominio è già associato al parametro SrvCall , questo nome di dominio verrà rimosso e la memoria associata a questa voce in SrvCall verrà liberata.
Se il parametro DomainName non è un puntatore NULL e il parametro DomainName ha una lunghezza maggiore di zero, RxSetSrvCallDomainName alloca spazio per il membro pDomainName di SrvCall da un pool non di paging con un tag pool di RX_SRVCALL_PARAMS_POOLTAG. La routine RxSetSrvCallDomainName imposta i membri buffer, length e MaximumLength della struttura pDomainName .
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | rxprocs.h (include Mrxfcb.h, Rxprocs.h) |
IRQL | <= APC_LEVEL |