Metode IServerSecurity::QueryBlanket (objidl.h)

Mengambil informasi tentang klien yang memanggil salah satu metode server.

Sintaks

HRESULT QueryBlanket(
  [out]     DWORD   *pAuthnSvc,
  [out]     DWORD   *pAuthzSvc,
  [out]     OLECHAR **pServerPrincName,
  [out]     DWORD   *pAuthnLevel,
  [out]     DWORD   *pImpLevel,
  [out]     void    **pPrivs,
  [in, out] DWORD   *pCapabilities
);

Parameter

[out] pAuthnSvc

Penunjuk ke layanan autentikasi saat ini. Ini akan menjadi nilai tunggal yang diambil dari daftar konstanta layanan autentikasi. Jika pemanggil menentukan NULL, layanan autentikasi saat ini tidak diambil.

[out] pAuthzSvc

Pointer ke variabel yang menerima layanan otorisasi saat ini. Ini akan menjadi nilai tunggal dari daftar konstanta otorisasi. Jika pemanggil menentukan NULL, layanan otorisasi saat ini tidak diambil.

[out] pServerPrincName

Nama utama saat ini. String akan dialokasikan oleh penerima panggilan menggunakan CoTaskMemAlloc, dan harus dibebaskan oleh pemanggil menggunakan CoTaskMemFree. Secara default, nama utama Schannel akan berada dalam bentuk msstd. Formulir fullsic akan dikembalikan jika EOAC_MAKE_FULLSIC ditentukan dalam parameter pCapabilities . Untuk informasi selengkapnya tentang formulir msstd dan fullsic, lihat Nama Utama. Jika pemanggil menentukan NULL, nama utama saat ini tidak diambil.

[out] pAuthnLevel

Penunjuk ke variabel yang menerima tingkat autentikasi saat ini. Ini akan menjadi nilai tunggal yang diambil dari daftar konstanta tingkat autentikasi. Jika pemanggil menentukan NULL, tingkat autentikasi saat ini tidak diambil.

[out] pImpLevel

Parameter ini harus NULL.

[out] pPrivs

Informasi hak istimewa untuk aplikasi klien. Format struktur yang dirujuk oleh handel bergantung pada layanan autentikasi. Aplikasi tidak boleh menulis atau membebaskan memori. Informasi ini hanya valid selama durasi panggilan saat ini. Untuk NTLMSSP, dan Kerberos, ini adalah struktur SEC_WINNT_AUTH_IDENTITY atau SEC_WINNT_AUTH_IDENTITY_EX . Untuk Schannel, ini adalah struktur CERT_CONTEXT yang mewakili sertifikat klien. Jika klien tidak memiliki sertifikat, NULL dikembalikan. Jika pemanggil menentukan NULL, informasi hak istimewa saat ini tidak diambil.

[in, out] pCapabilities

Kemampuan panggilan. Untuk meminta agar nama utama dikembalikan dalam bentuk penuh jika Schannel adalah layanan autentikasi, pemanggil dapat mengatur bendera EOAC_MAKE_FULLSIC dalam parameter ini. Jika pemanggil menentukan NULL, kapabilitas saat ini tidak diambil.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan S_OK.

Keterangan

QueryBlanket digunakan oleh server untuk mencari tahu tentang klien yang memanggil salah satu metodenya. Untuk mendapatkan penunjuk ke IServerSecurity untuk panggilan saat ini pada utas saat ini, panggil CoGetCallContext, yang menentukan IID_IServerSecurity. Pointer antarmuka ini hanya dapat digunakan di apartemen yang sama dengan panggilan selama panggilan.

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 objidl.h (termasuk ObjIdl.h)

Lihat juga

CoQueryClientBlanket

CoQueryProxyBlanket

IServerSecurity