Share via

Fungsi HttpInitialize (http.h)

  • Artikel

Fungsi HttpInitialize menginisialisasi driver HTTP Server API, memulainya, jika belum dimulai, dan mengalokasikan struktur data untuk aplikasi panggilan untuk mendukung pembuatan antrean respons dan operasi lainnya. Panggil fungsi ini sebelum memanggil fungsi lain di HTTP Server API.

Sintaks

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

Parameter

[in] Version

Versi HTTP. Parameter ini adalah struktur HTTPAPI_VERSION . Untuk versi saat ini, deklarasikan instans struktur dan atur ke nilai yang telah ditentukan sebelumnya HTTPAPI_VERSION_1 sebelum meneruskannya ke HttpInitialize.

[in] Flags

Opsi inisialisasi, yang dapat menyertakan salah satu atau kedua nilai berikut.

Nilai Makna
HTTP_INITIALIZE_CONFIG
 Lakukan inisialisasi untuk aplikasi yang menggunakan fungsi konfigurasi HTTP, HttpSetServiceConfiguration, HttpQueryServiceConfiguration, HttpDeleteServiceConfiguration, dan HttpIsFeatureSupported.
HTTP_INITIALIZE_SERVER
 Lakukan inisialisasi untuk aplikasi yang menggunakan API Server HTTP.

[in, out] pReserved

Parameter ini dicadangkan, dan harus NULL.

Nilai kembali

Jika fungsi berhasil, maka nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, maka nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai Makna
ERROR_INVALID_PARAMETER
 Parameter Bendera berisi nilai yang tidak didukung.
Lainnya
 Kode kesalahan sistem yang ditentukan dalam WinError.h.

Keterangan

Panggil HttpTerminate ketika aplikasi selesai. Semua bendera yang sama yang diteruskan ke HttpInitialize dalam parameter Bendera juga harus diteruskan ke HttpTerminate. Aplikasi dapat memanggil HttpInitialize berulang kali, asalkan setiap panggilan ke HttpInitialize kemudian dicocokkan dengan panggilan yang sesuai ke HttpTerminate.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header http.h
Pustaka Httpapi.lib
DLL Httpapi.dll

Lihat juga