Freigeben über

RxCeQueryInformation-Funktion (rxce.h)

  • Artikel

RxCeQueryInformation fragt Informationen zu einer Verbindung in einem vom Aufrufer zugewiesenen Puffer ab.

Syntax

NTSTATUS RxCeQueryInformation(
  [in]  IN PRXCE_VC                          pVc,
  [in]  IN RXCE_CONNECTION_INFORMATION_CLASS InformationClass,
  [out] OUT PVOID                            pInformation,
  [in]  IN ULONG                             Length
);

Parameter

[in] pVc

Ein Zeiger auf die virtuelle Verbindung, die dieser Verbindung zugeordnet ist.

[in] InformationClass

Die gewünschte Informationsklasse für diesen Abfragetyp. Der für InformationClass angegebene Wert bestimmt den Typ der zurückgegebenen Informationen. Dieser Parameter ist eine in rxcehdlr.h definierte Enumeration und kann einer der folgenden Werte sein:

RxCeTransportProviderInformation

Fragen Sie den Transport nach Anbieterinformationen ab. Eine RXCE_TRANSPORT_PROVIDER_INFO-Struktur wird bei Erfolg in den pInformation-Puffer kopiert. Beachten Sie, dass RXCE_TRANSPORT_PROVIDER_INFO eine Typdefinition für TDI_PROVIDER_INFO ist.

RxCeConnectionInformation

Abfrage: Informationen zur Verbindung. Eine RXCE_CONNECTION_INFORMATION-Struktur wird bei Erfolg in den pInformation-Puffer kopiert. Beachten Sie, dass RXCE_CONNECTION_INFORMATION eine Typdefinition für TDI_CONNECTION_INFORMATION ist.

RxCeConnectionEndpointInformation

Fragen Sie den Transport ab. Informationen zum Verbindungsendpunkt. Eine RXCE_CONNECTION_INFO-Struktur wird bei Erfolg in den pInformation-Puffer kopiert. Beachten Sie, dass RXCE_CONNECTION_INFO eine Typdefinition für TDI_CONNECTION_INFO ist.

RxCeRemoteAddressInformation

Fragen Sie den Transport ab. Informationen zur Remoteadresse. Eine TDI_ADDRESS_INFO-Struktur wird bei Erfolg in den pInformation-Puffer kopiert.

[out] pInformation

Der vom Aufrufer bereitgestellte Puffer für die Rückgabe von Informationen.

[in] Length

Die Länge des Puffers.

Rückgabewert

RxCeQueryInformation gibt STATUS_SUCCESS bei Erfolg oder einen der folgenden Warnungs- oder Fehlercodes zurück:

Rückgabecode Beschreibung
STATUS_BUFFER_OVERFLOW
 Diese angegebene Länge des Ausgabepuffers, auf den pInformation verweist, war nicht groß genug, um die vom Abfragetyp InformationClass angeforderten Informationen zu empfangen.
STATUS_INSUFFICIENT_RESOURCES
 Fehler bei der Zuordnung des nicht auslagerten Poolspeichers, der für diese Routine benötigt wird.
STATUS_INVALID_PARAMETER
 Dieser Wert kann für eine der folgenden Bedingungen zurückgegeben werden:
Der an diese Routine übergebene pVC-Parameter war ungültig.
Die für diese virtuelle Verbindung definierte Verbindung, Adresse oder Transport war ungültig.
Die InformationClass für diesen Abfragetyp war keiner der zulässigen Werte.

Hinweise

RxCeQueryInformation gibt Informationen für eine bestimmte virtuelle Verbindung zurück. Die einzigen Werte für InformationClass , die beim Aufrufen von RxCeQueryInformation angegeben werden können, sind die folgenden:

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

Für einige Werte von InformationClass ruft RxCeQueryInformationTdiBuildQueryInformation und TDI auf, um die angeforderten Informationen abzurufen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile rxce.h (include Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

Weitere Informationen

RxCeQueryAdapterStatus

RxCeQueryTransportInformation