Fungsi GopherCreateLocatorA (wininet.h)

Artikel
08/27/2023

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

Membuat string pencari Gopher atau Gopher+ dari bagian komponen string pemilih.

Sintaks

BOOL GopherCreateLocatorA(
  [in]      LPCSTR        lpszHost,
  [in]      INTERNET_PORT nServerPort,
  [in]      LPCSTR        lpszDisplayString,
  [in]      LPCSTR        lpszSelectorString,
  [in]      DWORD         dwGopherType,
  [out]     LPSTR         lpszLocator,
  [in, out] LPDWORD       lpdwBufferLength
);

Parameter

[in] lpszHost

Penunjuk ke string yang dihentikan null yang berisi nama host, atau alamat IP desimal putus-putus (seperti 198.105.232.1).

[in] nServerPort

Nomor port tempat server Gopher di lpszHost tinggal, dalam urutan byte host. Jika nServerPortINTERNET_INVALID_PORT_NUMBER, port Gopher default akan digunakan.

[in] lpszDisplayString

Penunjuk ke string yang dihentikan null yang berisi dokumen atau direktori Gopher yang akan ditampilkan. Jika parameter ini NULL, fungsi mengembalikan direktori default untuk server Gopher.

[in] lpszSelectorString

Arahkan ke string pemilih untuk dikirim ke server Gopher untuk mengambil informasi. Parameter ini bisa NULL.

[in] dwGopherType

Menentukan apakah lpszSelectorString mengacu pada direktori atau dokumen, dan apakah permintaannya adalah Gopher+ atau Gopher. Nilai default, GOPHER_TYPE_DIRECTORY, digunakan jika nilai dwGopherType adalah nol. Ini bisa menjadi salah satu nilai jenis gopher.

[out] lpszLocator

Penunjuk ke buffer yang menerima string pencari lokasi. Jika lpszLocator adalah NULL, lpdwBufferLength menerima panjang buffer yang diperlukan, tetapi fungsi tidak melakukan pemrosesan lain.

[in, out] lpdwBufferLength

Penunjuk ke variabel yang berisi panjang buffer lpszLocator , dalam karakter. Ketika fungsi kembali, parameter ini menerima jumlah karakter yang ditulis ke buffer. Jika GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER, parameter ini menerima jumlah karakter yang diperlukan.

Nilai kembali

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError atau InternetGetLastResponseInfo.

Keterangan

Untuk mengambil informasi dari server Gopher, aplikasi harus terlebih dahulu mendapatkan "pencari lokasi" Gopher dari server Gopher.

Pencari lokasi, yang harus diperlakukan aplikasi sebagai token buram, biasanya digunakan untuk panggilan ke fungsi GopherFindFirstFile untuk mengambil informasi tertentu.

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 GopherCreateLocator sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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


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