RxCeQueryInformation-Funktion (rxce.h)
RxCeQueryInformation Abfragen von Informationen zu einer Verbindung in einem vom Aufrufer zugewiesenen Puffer.
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 den virtuellen Schaltkreis, der 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 Enumeration, die in rxcehdlr.h definiert ist und einer der folgenden Werte sein kann:
RxCeTransportProviderInformation
Fragen Sie den Transport nach Anbieterinformationen ab. Eine RXCE_TRANSPORT_PROVIDER_INFO Struktur wird in den pInformation Puffer bei Erfolg kopiert. Beachten Sie, dass RXCE_TRANSPORT_PROVIDER_INFO ein Typedef für TDI_PROVIDER_INFO ist.
RxCeConnectionInformation
Abfrage nach Informationen zur Verbindung. Eine RXCE_CONNECTION_INFORMATION Struktur wird in den pInformation- Puffer bei Erfolg kopiert. Beachten Sie, dass RXCE_CONNECTION_INFORMATION ein Typedef für TDI_CONNECTION_INFORMATION ist.
RxCeConnectionEndpointInformation
Fragen Sie den Transport ab, um Informationen zum Verbindungsendpunkt zu erhalten. Eine RXCE_CONNECTION_INFO Struktur wird bei Erfolg in den pInformation Puffer kopiert. Beachten Sie, dass RXCE_CONNECTION_INFO ein Typedef für TDI_CONNECTION_INFO ist.
RxCeRemoteAddressInformation
Fragen Sie den Transport nach Informationen zur Remoteadresse ab. Eine TDI_ADDRESS_INFO Struktur wird bei Erfolg in den pInformation- Puffer kopiert.
[out] pInformation
Der vom Aufrufer bereitgestellte Puffer zum Zurückgeben von Informationen.
[in] Length
Die Länge des Puffers.
Rückgabewert
RxCeQueryInformation gibt STATUS_SUCCESS bei Erfolg oder einer der folgenden Warnungs- oder Fehlercodes zurück:
Rückgabecode | Beschreibung |
---|---|
|
Die angegebene Länge des Ausgabepuffers, auf den pInformation verweist, war nicht groß genug, um die vom InformationClass Abfragetyp angeforderten Informationen zu empfangen. |
|
Fehler bei der Zuordnung des nicht ausseitigen Poolspeichers, der von dieser Routine benötigt wird. |
|
Dieser Wert kann für eine der folgenden Bedingungen zurückgegeben werden:
|
Bemerkungen
RxCeQueryInformation Informationen für einen bestimmten virtuellen Schaltkreis 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 InformationClassruft RxCeQueryInformationTdiBuildQueryInformation und TDI auf, um die angeforderten Informationen abzurufen.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Desktop |
Header- | rxce.h (include Rxce.h, Rxcehdlr.h, Tdi.h) |
IRQL- | <= APC_LEVEL |