PMRX_GET_CONNECTION_ID Rückruffunktion (mrx.h)
DieMRxGetConnectionId Routine wird von RDBSS- aufgerufen, um anzufordern, dass ein Netzwerk-Miniumleitungsmodul eine Verbindungs-ID zurückgibt, die für die Behandlung 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
[in, out] Ein Zeiger auf die RX_CONTEXT-Struktur. Dieser Parameter enthält das IRP, das den Vorgang anfordert.
UniqueId
[in, out] Ein Zeiger auf die Verbindungs-ID, wenn die Routine zurückgegeben wird.
Rückgabewert
MRxGetConnectionId gibt STATUS_SUCCESS für erfolg oder einen geeigneten NTSTATUS-Wert zurück, z. B. folgendes:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_NOT_IMPLEMENTED | Diese Routine ist nicht implementiert. |
Bemerkungen
MRxGetConnectionId wird von RDBSS aufgerufen, wenn versucht wird, eine V_NET_ROOT Struktur zu suchen oder zu erstellen.
Wenn Verbindungs-IDs vom Netzwerk-Miniumleitungsmodul 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-by-Byte-Vergleich des Verbindungs-ID-Blobs aus, während die NetName-Tabelle nach einem bestimmten Namen mit einer Verbindungs-ID gesucht wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | mrx.h (einschließlich Mrx.h) |