fungsi lineGetAgentStatusA (tapi.h)

Fungsi lineGetAgentStatus mendapatkan status terkait agen pada alamat yang ditentukan.

Sintaksis

LONG lineGetAgentStatusA(
  HLINE             hLine,
  DWORD             dwAddressID,
  LPLINEAGENTSTATUS lpAgentStatus
);

Parameter

hLine

Tangani ke perangkat baris terbuka.

dwAddressID

Alamat pada perangkat baris terbuka yang status agennya akan dikueri. Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.

lpAgentStatus

Penunjuk ke struktur jenis yang bervariasi LINEAGENTSTATUS. Setelah berhasil menyelesaikan permintaan, struktur ini diisi dengan informasi status agen. Sebelum memanggil lineGetAgentStatus, aplikasi harus mengatur dwTotalSize anggota struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.

Catatan Jika parameter ukuran dalam struktur tidak benar, ada kemungkinan memori bisa ditimpa. Untuk informasi selengkapnya tentang pengaturan ukuran struktur, lihat topik alokasi memori .

 

Mengembalikan nilai

Mengembalikan pengidentifikasi permintaan positif jika operasi asinkron dimulai; jika tidak, salah satu nilai kesalahan negatif ini:

LINEERR_INVALADDRESSID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Komentar

Nota

Header tapi.h mendefinisikan lineGetAgentStatus sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
Platform Target	Windows
Header	tapi.h
Pustaka	Tapi32.lib
DLL	Tapi32.dll

Lihat juga

LINEAGENTSTATUS

Fungsi Layanan Garis Tambahan

Gambaran Umum Referensi TAPI 2.2