RxCreateSrvCall-Funktion (fcb.h)

RxCreateSrvCall erstellt eine SRV_CALL Struktur und fügt den Namen in die von RDBSS verwaltete Net Name-Tabelle ein.

Syntax

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

Parameter

[in] RxContext

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

[in] Name

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

InnerNamePrefix

[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 sein, in diesem Fall wird keine Verbindungs-ID dem Namen zugeordnet, der in der Präfixnamenstabelle eingefügt wird.

Rückgabewert

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

Hinweise

Die RxCreateSrvCall-Routine wird normalerweise nicht von Netzwerk-Mini-Umleitungstreibern 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. Diese IRP wird normalerweise von RDBSS als Reaktion auf eine Benutzermodusanwendung empfangen, die einen Dateierstellungsvorgang in einer Netzwerkfreigabe anfordert. Es ist auch möglich, dass ein anderer Kerneltreiber ein solches IRP ausgibt.

Vor dem Aufrufen von RxCreateSrvCall muss eine Sperre in der mit dem Geräteobjektelement des RxContext-Parameters verknüpften Namenstabelle im exklusiven Modus abgerufen werden.

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

Requirements (Anforderungen)

   
Zielplattform Desktop
Header fcb.h (include Rxcontx.h, Mrxfcb.h, Prefix.h, Fcb.h)
IRQL <= APC_LEVEL

Weitere Informationen

RX_CONTEXT

RxCreateNetFcb

RxCreateNetFobx

RxCreateNetRoot

RxCreateSrvOpen

RxCreateVNetRoot

RxDereference

RxFinalizeConnection

RxFinalizeNetFcb

RxFinalizeNetFobx

RxFinalizeNetRoot

RxFinalizeSrvCall

RxFinalizeSrvOpen

RxFinalizeVNetRoot

RxFinishFcbInitialization

RxForceFinalizeAllVNetRoots

RxReference

RxSetSrvCallDomainName

RxpDereferenceNetFcb

RxpReferenceNetFcb

Die SRV_CALL Struktur