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 correcto 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 paginada para almacenar el nuevo nombre de dominio.

Observaciones

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 al 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 pDomainName miembro de SrvCall del grupo no paginado con una etiqueta de grupo de RX_SRVCALL_PARAMS_POOLTAG. La rutina RxSetSrvCallDomainName establece el de búfer de, longitudy miembros MaximumLength de la estructura pDomainName de.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	rxprocs.h (incluya Mrxfcb.h, Rxprocs.h)
irQL	<= APC_LEVEL

Consulte también

RxCreateSrvCall

RxFinalizeSrvCall