Función RxSetSrvCallDomainName (rxprocs.h)

  • Artículo

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

Consulte también

RxCreateSrvCall

RxFinalizeSrvCall