Freigeben über


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
STATUS_BUFFER_OVERFLOW
Die angegebene Länge des Ausgabepuffers, auf den pInformation verweist, war nicht groß genug, um die vom InformationClass Abfragetyp angeforderten Informationen zu empfangen.
STATUS_INSUFFICIENT_RESOURCES
Fehler bei der Zuordnung des nicht ausseitigen Poolspeichers, der von dieser Routine benötigt wird.
STATUS_INVALID_PARAMETER
Dieser Wert kann für eine der folgenden Bedingungen zurückgegeben werden:
Der pVC- Parameter, der an diese Routine übergeben wurde, war ungültig.
Die für diesen virtuellen Schaltkreis definierte Verbindung, Adresse oder Transport war ungültig.
Die InformationClass- für diesen Abfragetyp war keine der zulässigen Werte.

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

Siehe auch

RxCeQueryAdapterStatus-

RxCeQueryTransportInformation