Fungsi GopherGetAttributeA (wininet.h)

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

Mengambil informasi atribut tertentu dari server.

Sintaksis

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 nulldihentikan 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 lpszAttributeNameNULL, 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

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

[in] lpfnEnumerator

Pointer ke fungsi callback 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 penguraian 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 sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError atau InternetGetLastResponseInfo.

Komentar

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.

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

 

Nota

Header wininet.h mendefinisikan GopherGetAttribute sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

Fungsi WinINet