Поделиться через

Функция RxCeQueryInformation (rxce.h)

  • Статья

RxCeQueryInformation запрашивает сведения о подключении в выделенном буфере вызывающего объекта.

Синтаксис

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

Параметры

[in] pVc

Указатель на виртуальный канал, связанный с этим подключением.

[in] InformationClass

Требуемый класс сведений для этого типа запроса. Значение, указанное для InformationClass, определяет тип возвращаемой информации. Этот параметр является перечислением, определенным в rxcehdlr.h и может быть одним из следующих значений:

RxCeTransportProviderInformation

Запрос транспорта для получения сведений о поставщике. Структура RXCE_TRANSPORT_PROVIDER_INFO копируется в буфер pInformation при успешном выполнении. Обратите внимание, что RXCE_TRANSPORT_PROVIDER_INFO — это типдифакт для TDI_PROVIDER_INFO.

RxCeConnectionInformation

Запрос сведений о подключении. Структура RXCE_CONNECTION_INFORMATION копируется в буфер pInformation при успешном выполнении. Обратите внимание, что RXCE_CONNECTION_INFORMATION является типизированным для TDI_CONNECTION_INFORMATION.

RxCeConnectionEndpointInformation

Запрос транспорта Для получения сведений о конечной точке подключения. Структура RXCE_CONNECTION_INFO копируется в буфер pInformation при успешном выполнении. Обратите внимание, что RXCE_CONNECTION_INFO является типизированным для TDI_CONNECTION_INFO.

RxCeRemoteAddressInformation

Запрос транспорта Для получения сведений об удаленном адресе. Структура TDI_ADDRESS_INFO копируется в буфер pInformation при успешном выполнении.

[out] pInformation

Буфер, предоставленный вызывающим объектом для возврата сведений.

[in] Length

Длина буфера.

Возвращаемое значение

RxCeQueryInformation возвращает STATUS_SUCCESS при успешном выполнении или одном из следующих кодов предупреждений или ошибок:

Возвращаемый код Описание
STATUS_BUFFER_OVERFLOW
 Эта указанная длина выходного буфера, на которую указывает pInformation, недостаточно велика, чтобы получить информацию, запрошенную типом запроса InformationClass.
STATUS_INSUFFICIENT_RESOURCES
 Сбой выделения памяти непагрегированного пула, необходимой для этой подпрограммы.
STATUS_INVALID_PARAMETER
 Это значение можно вернуть для любого из следующих условий:
Параметр pVC, переданный этой подпрограмме, был недопустим.
Соединение, адрес или транспорт, определенный для этого виртуального канала, был недопустим.
InformationClass для этого типа запроса не было одним из допустимых значений.

Замечания

RxCeQueryInformation возвращает сведения для данного виртуального канала. Ниже приведены единственные значения InformationClass InformationClass, которые можно указать при вызове RxCeQueryInformation.

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

Для некоторых значений InformationClassвызовы RxCeQueryInformation вызовы TdiBuildQueryInformation и TDI для получения запрошенных сведений.

Требования

Требование Ценность
целевая платформа Настольный
заголовка rxce.h (include Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

См. также

RxCeQueryAdapterStatus

RxCeQueryTransportInformation