PMRX_GET_CONNECTION_ID Rückruffunktion (mrx.h)
DieMRxGetConnectionId-Routine wird von RDBSS aufgerufen, um anzufordern, dass ein Netzwerk-Mini-Redirector eine Verbindungs-ID zurückgibt, die für die Verarbeitung mehrerer Sitzungen verwendet werden kann.
Syntax
PMRX_GET_CONNECTION_ID PmrxGetConnectionId;
NTSTATUS PmrxGetConnectionId(
IN OUT PRX_CONTEXT RxContext,
IN OUT PRX_CONNECTION_ID UniqueId
)
{...}
Parameter
RxContext
[ein, aus] Ein Zeiger auf die RX_CONTEXT-Struktur. Dieser Parameter enthält die IRP, die den Vorgang anfordert.
UniqueId
[ein, aus] Ein Zeiger auf die Verbindungs-ID, wenn die Routine zurückgibt.
Rückgabewert
MRxGetConnectionId gibt STATUS_SUCCESS bei Erfolg oder einen entsprechenden NTSTATUS-Wert zurück, z. B. den folgenden:
Rückgabecode | Beschreibung |
---|---|
STATUS_NOT_IMPLEMENTED | Diese Routine wird nicht implementiert. |
Hinweise
MRxGetConnectionId wird von RDBSS aufgerufen, wenn versucht wird, eine V_NET_ROOT-Struktur zu suchen oder zu erstellen.
Wenn Verbindungs-IDs vom Netzwerkminiumleitungsor unterstützt werden, wird die zurückgegebene Verbindungs-ID an den NET_ROOT Strukturnamen angefügt, der in der NetName-Tabelle gespeichert ist, die von RDBSS zum Speichern von Netzwerknamen verwendet wird. RDBSS betrachtet die Verbindungs-ID als undurchsichtiges Blob und führt einen Byte-byte-Vergleich des Verbindungs-ID-Blobs durch, während die NetName-Tabelle nach einem angegebenen Namen mit einer Verbindungs-ID gesucht wird.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | mrx.h (einschließlich Mrx.h) |