Bagikan melalui

Fungsi RxCeQueryInformation (rxce.h)

  • Artikel

RxCeQueryInformation mengkueri informasi tentang koneksi dalam buffer yang dialokasikan pemanggil.

Sintaks

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

Penunjuk ke sirkuit virtual yang terkait dengan koneksi ini.

[in] InformationClass

Kelas informasi yang diinginkan untuk jenis kueri ini. Nilai yang ditentukan untuk InformationClass menentukan jenis informasi yang dikembalikan. Parameter ini adalah enumerasi yang ditentukan dalam rxcehdlr.h dan dapat menjadi salah satu nilai berikut:

RxCeTransportProviderInformation

Mengkueri transportasi untuk informasi penyedia. Struktur RXCE_TRANSPORT_PROVIDER_INFO disalin ke buffer pInformation saat berhasil. Perhatikan bahwa RXCE_TRANSPORT_PROVIDER_INFO adalah typedef untuk TDI_PROVIDER_INFO.

RxCeConnectionInformation

Kueri Untuk informasi tentang koneksi. Struktur RXCE_CONNECTION_INFORMATION disalin ke buffer pInformation saat berhasil. Perhatikan bahwa RXCE_CONNECTION_INFORMATION adalah typedef untuk TDI_CONNECTION_INFORMATION.

RxCeConnectionEndpointInformation

Kueri transportasi Untuk informasi tentang titik akhir koneksi. Struktur RXCE_CONNECTION_INFO disalin ke buffer pInformation saat berhasil. Perhatikan bahwa RXCE_CONNECTION_INFO adalah typedef untuk TDI_CONNECTION_INFO.

RxCeRemoteAddressInformation

Kueri transportasi Untuk informasi tentang alamat jarak jauh. Struktur TDI_ADDRESS_INFO disalin ke buffer pInformation saat berhasil.

[out] pInformation

Buffer yang disediakan penelepon untuk mengembalikan informasi.

[in] Length

Panjang buffer.

Nilai kembali

RxCeQueryInformation mengembalikan STATUS_SUCCESS pada keberhasilan atau salah satu kode peringatan atau kesalahan berikut:

Menampilkan kode Deskripsi
STATUS_BUFFER_OVERFLOW
 Panjang buffer output yang ditentukan yang diacu oleh pInformation tidak cukup besar untuk menerima informasi yang diminta oleh jenis kueri InformationClass.
STATUS_INSUFFICIENT_RESOURCES
 Alokasi memori kumpulan yang tidak disebarkan yang diperlukan oleh rutinitas ini gagal.
STATUS_INVALID_PARAMETER
 Nilai ini dapat dikembalikan untuk salah satu kondisi berikut:
Parameter pVC yang diteruskan ke rutinitas ini tidak valid.
Koneksi, alamat, atau transportasi yang ditentukan untuk sirkuit virtual ini tidak valid.
InformationClass untuk jenis kueri ini bukan salah satu nilai yang diizinkan.

Keterangan

RxCeQueryInformation mengembalikan informasi untuk sirkuit virtual tertentu. Satu-satunya nilai untuk InformationClass yang dapat ditentukan saat memanggil RxCeQueryInformation adalah sebagai berikut:

RxCeTransportProviderInformation

RxCeConnectionInformation

RxCeConnectionEndpointInformation

RxCeRemoteAddressInformation

Untuk beberapa nilai InformationClass, RxCeQueryInformation memanggil TdiBuildQueryInformation dan TDI untuk mengambil informasi yang diminta.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header rxce.h (termasuk Rxce.h, Rxcehdlr.h, Tdi.h)
IRQL <= APC_LEVEL

Lihat juga

RxCeQueryAdapterStatus

RxCeQueryTransportInformation