RxCreateVNetRoot-Funktion (fcb.h)

Artikel
02/06/2025

RxCreateVNetRoot eine NET_ROOT Struktur zuordnet und initialisiert und fügt den Namen in die Net Name-Tabelle des zugeordneten Geräteobjekts ein.

Syntax

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
);

Parameter

[in] RxContext

Ein Zeiger auf das RDBSS-RX_CONTEXT mit dem IRP, das einen Erstellungsvorgang beschreibt.

[in] NetRoot

Ein Zeiger auf die zugeordnete NET_ROOT Struktur.

[in] CanonicalName

Ein Zeiger auf den kanonischen Namen, der in die Namenstabelle eingefügt werden soll.

[in] LocalNetRootName

Ein Zeiger auf den lokalen NET_ROOT Namen ohne den Präfixnamen.

[in] FilePath

Ein Zeiger auf einen Dateinamen. Dieser Parameter wird derzeit nicht verwendet und kann NULL-werden.

[in] RxConnectionId

Ein Zeiger auf die Verbindungs-ID, die dem Namen zugeordnet werden soll, der in die Präfixnamentabelle eingefügt werden soll. Dieser Parameter kann NULL- werden, in diesem Fall wird keine Verbindungs-ID mit dem in die Namenstabelle eingefügten Namen verknüpft.

Rückgabewert

RxCreateVNetRoot- gibt einen Zeiger auf eine neu erstellte V_NET_ROOT Datenstruktur für Erfolg oder einen NULL- Zeiger beim Fehler zurück.

Bemerkungen

Die RxCreateVNetRoot Routine wird normalerweise nicht direkt von Netzwerk-Miniumleitungstreibern aufgerufen. RDBSS ruft diese Routine intern auf, wenn ein E/A-Anforderungspaket für IRP_MJ_CREATE empfangen wird und eine V_NET_ROOT erstellt werden muss. Dieses IRP wird normalerweise von RDBSS als Reaktion auf eine Benutzermodusanwendung empfangen, die einen Dateierstellungsvorgang auf einer Netzwerkfreigabe anfordert. Es ist auch möglich, dass ein anderer Kerneltreiber ein solches IRP ausgibt.

Vor dem Aufrufen RxCreateVNetRootmuss eine Sperre für die Namenstabelle, die dem Geräteobjektmemm des RxContext- Parameters zugeordnet ist, im exklusiven Modus abgerufen werden.

RxCreateVNetRoot legt eine Vielzahl von Sicherheitskontextparametern für die V_NET_ROOT Struktur basierend auf Parametern aus dem RX_CONTEXT fest. Zu diesen Parametern gehören: LogonId, SessionId, pUserName, pUserDomainName, pPasswordund Flags.