Fungsi panggilan balik SpQueryContextAttributesFn (ntsecpkg.h)

  • Artikel

Fungsi SpQueryContextAttributes mengambil atribut konteks keamanan.

Fungsi SpQueryContextAttributes adalah fungsi pengiriman untuk fungsi QueryContextAttributes (Umum) dari Antarmuka Penyedia Dukungan Keamanan.

Sintaks

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

Parameter

[in] ContextHandle

Handel ke konteks keamanan.

[in] ContextAttribute

Atribut konteks untuk kueri. Untuk daftar nilai yang valid, lihat fungsi QueryContextAttributes (Umum).

[out] Buffer

Pointer yang menerima alamat buffer yang berisi atribut yang diminta. Memori untuk parameter Buffer harus dialokasikan dengan fungsi AllocateHeap dari tabel fungsi SECPKG_DLL_FUNCTIONS dalam mode pengguna. Dalam mode Otoritas Keamanan Lokal (LSA), gunakan fungsi AllocateLsaHeap .

Nilai kembali

Jika fungsi berhasil, kembalikan STATUS_SUCCESS.

Jika fungsi gagal, kembalikan kode NTSTATUS yang menunjukkan alasan gagalnya. Berikut ini mencantumkan alasan umum kegagalan dan kode kesalahan yang harus dikembalikan fungsi.

Menampilkan kode Deskripsi
SEC_E_INVALID_HANDLE
 Handel tidak valid.

Keterangan

SSP/APs harus mengimplementasikan fungsi SpQueryContextAttributes ; namun, nama aktual yang diberikan untuk implementasi terserah pengembang.

Penunjuk ke implementasi mode LSA dari fungsi SpQueryContextAttributes tersedia dalam struktur SECPKG_FUNCTION_TABLE yang diterima dari fungsi SpLsaModeInitialize .

Penunjuk ke implementasi mode pengguna dari fungsi SpQueryContextAttributes tersedia dalam struktur SECPKG_USER_FUNCTION_TABLE yang diterima dari fungsi SpUserModeInitialize .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header ntsecpkg.h

Lihat juga

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize