Fungsi CoQueryAuthenticationServices (combaseapi.h)

Mengambil daftar layanan autentikasi yang terdaftar ketika proses yang disebut CoInitializeSecurity.

Sintaks

HRESULT CoQueryAuthenticationServices(
  [out] DWORD                       *pcAuthSvc,
  [out] SOLE_AUTHENTICATION_SERVICE **asAuthSvc
);

Parameter

[out] pcAuthSvc

Penunjuk ke variabel yang menerima jumlah entri yang dikembalikan dalam array asAuthSvc .

[out] asAuthSvc

Penunjuk ke array struktur SOLE_AUTHENTICATION_SERVICE . Daftar dialokasikan melalui panggilan ke fungsi CoTaskMemAlloc . Pemanggil harus membebaskan daftar ketika selesai dengan memanggil fungsi CoTaskMemFree .

Nilai kembali

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

Keterangan

CoQueryAuthenticationServices mengambil daftar layanan autentikasi yang saat ini terdaftar. Jika proses memanggil CoInitializeSecurity, ini adalah layanan yang terdaftar melalui panggilan tersebut. Jika aplikasi tidak menyebutnya, CoInitializeSecurity dipanggil secara otomatis oleh COM, mendaftarkan paket keamanan default, pertama kali antarmuka di-marshalasi atau tidak diawasi.

Fungsi ini hanya mengembalikan layanan autentikasi yang terdaftar di CoInitializeSecurity. Ini tidak mengembalikan semua layanan autentikasi yang diinstal pada komputer, tetapi EnumerateSecurityPackages melakukannya. CoQueryAuthenticationServices terutama berguna untuk marshaler kustom, untuk menentukan nama utama mana yang dapat digunakan aplikasi.

Layanan autentikasi yang berbeda mendukung tingkat keamanan yang berbeda. Misalnya, NTLMSSP tidak mendukung delegasi atau autentikasi bersama saat Kerberos melakukannya. Aplikasi ini hanya bertanggung jawab untuk mendaftarkan layanan autentikasi yang menyediakan fitur yang dibutuhkan aplikasi. Fungsi ini menyediakan cara untuk mengetahui layanan mana yang telah terdaftar di CoInitializeSecurity.

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	combaseapi.h (termasuk Objbase.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

CoInitializeSecurity

SOLE_AUTHENTICATION_SERVICE

Keamanan di COM