RxCreateNetRoot-Funktion (fcb.h)

Artikel
02/06/2025

RxCreateNetRoot eine NET_ROOT Struktur zuordnet und initialisiert und fügt den Namen in die Net Name-Tabelle im zugeordneten Geräteobjekt ein.

Syntax

PNET_ROOT RxCreateNetRoot(
  [in]           IN PSRV_CALL         SrvCall,
  [in]           IN PUNICODE_STRING   Name,
  [in]           IN ULONG             NetRootFlags,
  [in, optional] IN PRX_CONNECTION_ID RxConnectionId
);

Parameter

[in] SrvCall

Ein Zeiger auf die zugeordnete SRV_CALL Struktur.

[in] Name

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

[in] NetRootFlags

Der Wert zum Festlegen der Flags Member der NET_ROOT, die verwendet wird, um den Zustand der NET_ROOT Struktur zu kennzeichnen.

[in, optional] 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 der Präfixnamentabelle eingefügten Namen verknüpft.

Rückgabewert

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

Bemerkungen

Die RxCreateNetRoot Routine wird normalerweise nicht von Netzwerk-Miniumleitungstreibern direkt aufgerufen. RDBSS ruft diese Routine intern auf, wenn ein E/A-Anforderungspaket für IRP_MJ_CREATE empfangen wird und eine 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 RxCreateNetRoot-muss eine Sperre für die Namenstabelle, die dem Geräteobjektmemm des SrvCall-Parameters zugeordnet ist, im exklusiven Modus abgerufen werden.

Die NET_ROOT Flags sind in zwei Gruppen unterteilt, die für Netzwerk-Miniumleitungen sichtbar sind und für Netzwerk-Miniumleitungen unsichtbar sind. Die sichtbaren sind die unteren 16 Bit der Flags Mitglied der NET_ROOT. Diese Routine überprüft oder testet nicht, welche Flags festgelegt werden.

Bei Erfolg wird die Referenzanzahl für die SRV_CALL Struktur erhöht.