Funzione RxCeQueryInformation (rxce.h)

  • Articolo

RxCeQueryInformation esegue query sulle informazioni su una connessione in un buffer allocato dal chiamante.

Sintassi

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

Parametri

[in] pVc

Puntatore al circuito virtuale associato a questa connessione.

[in] InformationClass

Classe di informazioni desiderata per questo tipo di query. Il valore specificato per InformationClass determina il tipo di informazioni restituite. Questo parametro è un'enumerazione definita in rxcehdlr.h e può essere uno dei valori seguenti:

RxCeTransportProviderInformation

Eseguire una query sul trasporto per ottenere informazioni sul provider. Una struttura RXCE_TRANSPORT_PROVIDER_INFO viene copiata nel buffer pInformation in caso di esito positivo. Si noti che RXCE_TRANSPORT_PROVIDER_INFO è un typedef per TDI_PROVIDER_INFO.

RxCeConnectionInformation

Query Per informazioni sulla connessione. Una struttura RXCE_CONNECTION_INFORMATION viene copiata nel buffer pInformation in caso di esito positivo. Si noti che RXCE_CONNECTION_INFORMATION è un typedef per TDI_CONNECTION_INFORMATION.

RxCeConnectionEndpointInformation

Eseguire una query sul trasporto Per informazioni sull'endpoint di connessione. Una struttura RXCE_CONNECTION_INFO viene copiata nel buffer pInformation in caso di esito positivo. Si noti che RXCE_CONNECTION_INFO è un typedef per TDI_CONNECTION_INFO.

RxCeRemoteAddressInformation

Eseguire una query sul trasporto Per informazioni sull'indirizzo remoto. Una struttura TDI_ADDRESS_INFO viene copiata nel buffer pInformation in caso di esito positivo.

[out] pInformation

Buffer fornito dal chiamante per la restituzione di informazioni.

[in] Length

Lunghezza del buffer.

Valore restituito

RxCeQueryInformation restituisce STATUS_SUCCESS in caso di esito positivo o uno dei codici di errore o di avviso seguenti:

Codice restituito Descrizione
STATUS_BUFFER_OVERFLOW
 La lunghezza specificata del buffer di output a cui punta pInformation non è sufficiente per ricevere le informazioni richieste dal tipo di query InformationClass .
STATUS_INSUFFICIENT_RESOURCES
 L'allocazione della memoria del pool non di paging necessaria per questa routine non è riuscita.
STATUS_INVALID_PARAMETER
 Questo valore può essere restituito per una delle condizioni seguenti:
Il parametro pVC passato a questa routine non è valido.
La connessione, l'indirizzo o il trasporto definito per questo circuito virtuale non è valido.
InformationClass per questo tipo di query non è uno dei valori consentiti.

Commenti

RxCeQueryInformation restituisce informazioni per un determinato circuito virtuale. Gli unici valori per InformationClass che possono essere specificati quando si chiama RxCeQueryInformation sono i seguenti:

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

Per alcuni valori di InformationClass, RxCeQueryInformation chiama TdiBuildQueryInformation e TDI per recuperare le informazioni richieste.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione rxce.h (include Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

Vedi anche

RxCeQueryAdapterStatus

RxCeQueryTransportInformation