RxCreateNetRoot-Funktion (fcb.h)

Artikel
02/29/2024

RxCreateNetRoot weist und initialisiert eine NET_ROOT-Struktur und fügt den Namen in die Net Name-Tabelle des zugeordneten Geräteobjekts 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, um das Flags-Element des NET_ROOT festzulegen, der verwendet wird, um den Zustand der NET_ROOT-Struktur anzugeben.

[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 sein. In diesem Fall wird keine Verbindungs-ID dem in die Präfixnamentabelle eingefügten Namen zugeordnet.

Rückgabewert

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

Hinweise

Die RxCreateNetRoot-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 ein NET_ROOT erstellt werden muss. Diese IRP wird normalerweise von RDBSS als Reaktion auf eine Benutzermodusanwendung empfangen, die einen Dateierstellungsvorgang für eine Netzwerkfreigabe anfordert. Es ist auch möglich, dass ein anderer Kerneltreiber eine solche IRP ausgibt.

Vor dem Aufrufen von RxCreateNetRoot muss im exklusiven Modus eine Sperre für die Namenstabelle abgerufen werden, die dem Member des Geräteobjekts des SrvCall-Parameters zugeordnet ist.

Die NET_ROOT Flags sind in zwei Gruppen unterteilt: die für Netzwerkminiumleitungen sichtbaren und die für Netzwerkminiumleitungen unsichtbaren Flags. Die sichtbaren sind die unteren 16-Bits des Flags-Members des 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.