struktur WINHTTP_CREDS (winhttp.h)

Struktur WINHTTP_CREDS berisi informasi kredensial pengguna yang digunakan untuk autentikasi server dan proksi.

Catatan Struktur ini sudah tidak digunakan lagi. Sebaliknya, penggunaan struktur WINHTTP_CREDS_EX disarankan.

 

Sintaks

typedef struct tagWINHTTP_CREDS {
  LPSTR lpszUserName;
  LPSTR lpszPassword;
  LPSTR lpszRealm;
  DWORD dwAuthScheme;
  LPSTR lpszHostName;
  DWORD dwPort;
} WINHTTP_CREDS, *PWINHTTP_CREDS;

Anggota

lpszUserName

Penunjuk ke buffer yang berisi nama pengguna.

lpszPassword

Penunjuk ke buffer yang berisi kata sandi.

lpszRealm

Pointer ke buffer yang berisi realm.

dwAuthScheme

Bendera yang berisi skema autentikasi, sebagai salah satu nilai berikut.

Nilai	Makna
WINHTTP_AUTH_SCHEME_BASIC	Gunakan autentikasi dasar.
WINHTTP_AUTH_SCHEME_NTLM	Gunakan autentikasi NTLM.
INHTTP_AUTH_SCHEME_DIGEST	Gunakan autentikasi hash.
WINHTTP_AUTH_SCHEME_NEGOTIATE	Pilih antara autentikasi NTLM dan Kerberos.

lpszHostName

Penunjuk ke buffer yang berisi nama host.

dwPort

Port koneksi server.

Keterangan

Struktur ini digunakan dengan opsi WINHTTP_OPTION_GLOBAL_SERVER_CREDS dan bendera opsiWINHTTP_OPTION_GLOBAL_PROXY_CREDS. Opsi ini memerlukan kunci registri HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Kunci registri ini tidak ada secara default.

Ketika diatur, WinINet akan mengirim kredensial ke WinHTTP. Setiap kali WinHttp mendapatkan tantangan autentikasi dan jika tidak ada kredensial yang diatur pada handel saat ini, winhttp akan menggunakan kredensial yang disediakan oleh WinINet. Untuk berbagi kredensial server selain kredensial proksi, pengguna perlu mengatur bendera opsi WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	winhttp.h

Lihat juga

WINHTTP_CREDS_EX