Fungsi panggilan balik SpQueryMetaDataFn (ntsecpkg.h)

  • Artikel

Mendapatkan metadata dari penyedia dukungan keamanan (SSP) saat memulai konteks keamanan.

Sintaks

SpQueryMetaDataFn Spquerymetadatafn;

NTSTATUS Spquerymetadatafn(
  [in]           LSA_SEC_HANDLE CredentialHandle,
  [in, optional] PUNICODE_STRING TargetName,
  [in]           ULONG ContextRequirements,
  [out]          PULONG MetaDataLength,
  [out]          PUCHAR *MetaData,
  [in, out]      PLSA_SEC_HANDLE ContextHandle
)
{...}

Parameter

[in] CredentialHandle

Handel ke kredensial yang akan digunakan untuk konteks keamanan. Jika parameter ContextHandle menunjuk ke NULL pada input, fungsi ini menggunakan nilai parameter ini untuk membuat konteks keamanan.

Nilai parameter ini tidak boleh NULL jika parameter ContextHandle menunjuk ke NULL pada input.

[in, optional] TargetName

Penunjuk ke UNICODE_STRING yang berisi nama target konteks.

[in] ContextRequirements

Bendera yang menunjukkan atribut konteks yang diperlukan oleh klien.

Berikut ini adalah nilai yang valid. Nilai dapat digabungkan dengan menggunakan operasi OR logis.

Nilai Makna
ISC_REQ_DELEGATE
 Server diizinkan untuk meniru klien.
ISC_REQ_MUTUAL_AUTH
 Klien dan server diperlukan untuk membuktikan identitas mereka.
ISC_REQ_REPLAY_DETECT
 Konteks keamanan akan mendukung deteksi paket yang diputar ulang.
ISC_REQ_SEQUENCE_DETECT
 Konteks keamanan akan mendukung deteksi pesan yang tidak berurutan.
ISC_REQ_USE_SESSION_KEY
 Kunci sesi baru harus dinegosiasikan.
ISC_REQ_PROMPT_FOR_CREDS
 Jika klien adalah pengguna interaktif, paket harus, jika memungkinkan, meminta kredensial yang sesuai kepada pengguna.
ISC_REQ_USE_SUPPLIED_CREDS
 Buffer input berisi informasi kredensial khusus paket yang harus digunakan untuk mengautentikasi koneksi.
ISC_REQ_ALLOCATE_MEMORY
 Paket harus mengalokasikan memori. Pemanggil akhirnya harus memanggil fungsi FreeContextBuffer untuk membebaskan memori yang dialokasikan oleh paket.
ISC_REQ_USE_DCE_STYLE
 Pemanggil mengharapkan transaksi autentikasi timbal balik tiga kaki.
ISC_REQ_DATAGRAM
 Saluran komunikasi jenis datagram harus digunakan. Untuk informasi selengkapnya, lihat Konteks Datagram.
ISC_REQ_CONNECTION
 Saluran komunikasi jenis koneksi harus digunakan. Untuk informasi selengkapnya, lihat Konteks Berorientasi Koneksi.
ISC_REQ_EXTENDED_ERROR
 Jika konteks gagal, buat pesan balasan kesalahan untuk dikirim kembali ke klien.
ISC_REQ_STREAM
 Saluran komunikasi jenis aliran harus digunakan. Untuk informasi selengkapnya, lihat konteks Stream.
ISC_REQ_INTEGRITY
 Integritas buffer diverifikasi; namun, pesan yang diputar ulang dan tidak berurutan tidak akan terdeteksi.

[out] MetaDataLength

Ukuran, dalam karakter, dari buffer MetaData .

[out] MetaData

Metadata yang disediakan SSP.

[in, out] ContextHandle

Handel ke handel keamanan yang akan digunakan. Jika parameter ini menunjuk ke NULL pada input, fungsi ini mengalokasikan dan menginisialisasi konteks keamanan dengan menggunakan nilai parameter CredentialHandle dan TargetName .

Jika parameter ini menunjuk ke NULL pada input, CredentialHandle tidak boleh NULL.

Nilai kembali

Jika fungsi berhasil, kembalikan STATUS_SUCCESS, atau kode status informasi.

Jika fungsi gagal, kembalikan kode kesalahan NTSTATUS yang menunjukkan alasan gagalnya. Untuk informasi selengkapnya, lihat Keterangan.

Keterangan

Penunjuk ke fungsi SpQueryMetaDataFn tersedia dalam struktur SECPKG_FUNCTION_TABLE yang diterima dari fungsi SpLsaModeInitialize .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header ntsecpkg.h