RxCreateSrvCall-Funktion (fcb.h)

Artikel
02/06/2025

RxCreateSrvCall erstellt eine SRV_CALL Struktur und fügt den Namen in die von RDBSS verwaltete Netznamentabelle ein.

Syntax

PSRV_CALL RxCreateSrvCall(
  IN PRX_CONTEXT       RxContext,
  IN PUNICODE_STRING   Name,
  IN PUNICODE_STRING   InnerNamePrefix,
  IN PRX_CONNECTION_ID RxConnectionId
);

Parameter

RxContext

[in] Ein Zeiger auf die RX_CONTEXT Struktur, die das IRP enthält, das einen Erstellungsvorgang beschreibt.

Name

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

InnerNamePrefix

Ein Zeiger auf einen optionalen inneren Präfixnamen, der in die Namenstabelle mit dem Nameeingefügt werden soll.

RxConnectionId

[in] 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

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

Bemerkungen

Die RxCreateSrvCall 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 ein SRV_CALL 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 RxCreateSrvCallmuss eine Sperre für die Namenstabelle, die dem Geräteobjektmemm des RxContext- Parameters zugeordnet ist, im exklusiven Modus abgerufen werden.

RxCreateSrvCall initialisiert die Serveraufrufparameter, die über erweiterte Attribute als Teil der zugeordneten RX_CONTEXT-Struktur übergeben werden. Derzeit umfasst dies die Initialisierung des pPrincipalName- Mitglieds der SRV_CALL, die vom DFS-Treiber übergeben wird.