Funzione RxSetSrvCallDomainName (rxprocs.h)

  • Articolo

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
STATUS_INSUFFICIENT_RESOURCES
 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

Vedi anche

RxCreateSrvCall

RxFinalizeSrvCall