Función RxCreateVNetRoot (fcb.h)

Artículo
02/06/2025

RxCreateVNetRoot asigna e inicializa una estructura de NET_ROOT e inserta el nombre en la tabla net name del objeto de dispositivo asociado.

Sintaxis

PV_NET_ROOT RxCreateVNetRoot(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PNET_ROOT         NetRoot,
  [in] IN PUNICODE_STRING   CanonicalName,
  [in] IN PUNICODE_STRING   LocalNetRootName,
  [in] IN PUNICODE_STRING   FilePath,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

Parámetros

[in] RxContext

Puntero al RX_CONTEXT RDBSS que contiene el IRP que describe una operación de creación.

[in] NetRoot

Puntero a la estructura de NET_ROOT asociada.

[in] CanonicalName

Puntero al nombre canónico que se va a insertar en la tabla de nombres.

[in] LocalNetRootName

Puntero al nombre del NET_ROOT local sin el nombre del prefijo.

[in] FilePath

Puntero a un nombre de ruta de acceso de archivo. Este parámetro no se usa actualmente y se puede null.

[in] RxConnectionId

Puntero al identificador de conexión que se va a asociar al nombre que se va a insertar en la tabla de nombres de prefijo. Este parámetro puede ser null en cuyo caso no se asociará ningún identificador de conexión con el nombre insertado en la tabla de nombres.

Valor devuelto

RxCreateVNetRoot devuelve un puntero a una estructura de datos de V_NET_ROOT recién creada cuando se ejecuta correctamente o un puntero de NULL en caso de error.

Observaciones

Normalmente, los controladores de minidirector de red no llaman a la rutina de RxCreateVNetRoot. RDBSS llama a esta rutina internamente cuando se recibe un paquete de solicitud de E/S para IRP_MJ_CREATE y se debe crear un V_NET_ROOT. RDBSS recibe normalmente este IRP en respuesta a una aplicación en modo de usuario que solicita una operación de creación de archivos en un recurso compartido de red. También es posible que otro controlador de kernel emita este tipo de IRP.

Antes de llamar a RxCreateVNetRoot, se debe adquirir un bloqueo en la tabla de nombres asociada al miembro del objeto de dispositivo del parámetro RxContext en modo exclusivo.

RxCreateVNetRoot establece una variedad de parámetros de contexto de seguridad en la estructura de V_NET_ROOT en función de los parámetros de la RX_CONTEXT. Estos parámetros incluyen lo siguiente: logonId, SessionId, pUserName, pUserDomainName, pPasswordy Flags.