Fungsi GopherGetAttributeA (wininet.h)

Artikel
08/27/2023

[Fungsi GopherGetAttribute tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan.]

Mengambil informasi atribut tertentu dari server.

Sintaks

BOOL GopherGetAttributeA(
  [in]  HINTERNET                   hConnect,
  [in]  LPCSTR                      lpszLocator,
  [in]  LPCSTR                      lpszAttributeName,
  [out] LPBYTE                      lpBuffer,
  [in]  DWORD                       dwBufferLength,
  [out] LPDWORD                     lpdwCharactersReturned,
  [in]  GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator,
  [in]  DWORD_PTR                   dwContext
);

Parameter

[in] hConnect

Menangani ke sesi Gopher yang dikembalikan oleh InternetConnect.

[in] lpszLocator

Penunjuk ke string yang dihentikan null yang mengidentifikasi item di server Gopher tempat mengembalikan informasi atribut.

[in] lpszAttributeName

Penunjuk ke string yang dibatasi spasi yang menentukan nama atribut yang akan dikembalikan. Jika lpszAttributeName adalah NULL, GopherGetAttribute mengembalikan informasi tentang semua atribut.

[out] lpBuffer

Penunjuk ke buffer yang ditentukan aplikasi dari mana informasi atribut diambil.

[in] dwBufferLength

Ukuran buffer lpBuffer , dalam TCHAR.

[out] lpdwCharactersReturned

Penunjuk ke variabel yang berisi jumlah karakter yang dibaca ke dalam buffer lpBuffer .

[in] lpfnEnumerator

Penunjuk ke fungsi panggilan balik GopherAttributeEnumerator yang menghitung setiap atribut pencari lokasi. Parameter ini bersifat opsional. Jika NULL, semua informasi atribut Gopher ditempatkan ke dalam lpBuffer. Jika lpfnEnumerator ditentukan, fungsi panggilan balik dipanggil sekali untuk setiap atribut objek.

Fungsi panggilan balik menerima alamat struktur GOPHER_ATTRIBUTE_TYPE tunggal dengan setiap panggilan. Fungsi panggilan balik enumerasi memungkinkan aplikasi untuk menghindari harus mengurai informasi atribut Gopher.

[in] dwContext

Nilai yang ditentukan aplikasi yang mengaitkan operasi ini dengan data aplikasi apa pun.

Mengembalikan nilai

Mengembalikan TRUE jika permintaan terpenuhi, atau FALSE jika tidak. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError atau InternetGetLastResponseInfo.

Keterangan

Umumnya, aplikasi memanggil fungsi ini setelah memanggil GopherFindFirstFile atau InternetFindNextFile.

Ukuran parameter lpBuffer harus sama dengan atau lebih besar dari nilai MIN_GOPHER_ATTRIBUTE_LENGTH.

Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

Catatan

Header wininet.h mendefinisikan GopherGetAttribute sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

Fungsi WinINet