Función RxSetSrvCallDomainName (rxprocs.h)
Un controlador minidirector de red llama a RxSetSrvCallDomainName para establecer el nombre de dominio asociado a cualquier servidor determinado (SRV_CALL estructura).
Sintaxis
NTSTATUS RxSetSrvCallDomainName(
[in] IN PMRX_SRV_CALL SrvCall,
[in] IN PUNICODE_STRING DomainName
);
Parámetros
[in] SrvCall
Puntero a la estructura SRV_CALL.
[in] DomainName
Puntero a un búfer que contiene una cadena Unicode terminada en cero que asigna un nombre al dominio al que pertenece este servidor.
Valor devuelto
RxSetSrvCallDomainName devuelve STATUS_SUCCESS si se ejecuta correctamente o uno de los siguientes valores de error en caso de error:
| Código devuelto | Descripción |
|---|---|
|
No había recursos suficientes para completar esta rutina. Error en la solicitud de asignación de memoria para la memoria del grupo no paginado para almacenar el nuevo nombre de dominio. |
Comentarios
Es posible que el nombre de dominio no se conozca al principio de una solicitud de redirector de red. La rutina RxSetSrvCallDomainName permite asociar el nombre de dominio a SrvCall una vez que se conoce. Normalmente, esta rutina se usaría como parte de la creación e inicialización de una estructura de SRV_CALL.
Si un nombre de dominio ya está asociado con el parámetro SrvCall , este nombre de dominio se quitará y se liberará la memoria asociada a esta entrada en SrvCall .
Si el parámetro DomainName no es un puntero NULL y el parámetro DomainName tiene una longitud mayor que cero, RxSetSrvCallDomainName asigna espacio para el miembro pDomainName de SrvCall del grupo no paginado con una etiqueta de grupo de RX_SRVCALL_PARAMS_POOLTAG. La rutina RxSetSrvCallDomainName establece los miembros buffer, length y MaximumLength de la estructura pDomainName .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | rxprocs.h (incluya Mrxfcb.h, Rxprocs.h) |
| IRQL | <= APC_LEVEL |