Bagikan melalui

Fungsi SaslSetContextOption (sspi.h)

  • Artikel

Fungsi SaslSetContextOption menetapkan nilai properti yang ditentukan untuk konteks SASL yang ditentukan.

Sintaks

SECURITY_STATUS SEC_ENTRY SaslSetContextOption(
  [in] PCtxtHandle ContextHandle,
  [in] ULONG       Option,
  [in] PVOID       Value,
  [in] ULONG       Size
);

Parameter

[in] ContextHandle

Menangani konteks SASL.

[in] Option

Properti yang akan diatur untuk konteks SASL. Tabel berikut mencantumkan nilai yang mungkin.

Nilai Makna
SASL_OPTION_AUTHZ_PROCESSING
 Jenis data buffer: ULONG

Status pemrosesan SASL dari nilai Authz yang disediakan oleh aplikasi SASL. Status yang valid untuk pemrosesan Sasl_AuthZIDForbidden dan Sasl_AuthZIDProcessed. Nilai defaultnya adalah Sasl_AuthZIDProcessed.
SASL_OPTION_AUTHZ_STRING
 Jenis data buffer: Array karakter biner

String karakter yang diteruskan dari klien SASL ke server. Jika status AuthZ_Processing Sasl_AuthZIDForbidden, nilai yang dikembalikan SEC_E_UNSUPPORTED_FUNCTION dikembalikan.
SASL_OPTION_RECV_SIZE
 Jenis data buffer: ULONG

Ukuran maksimum buffer penerima di komputer lokal. Nilai defaultnya adalah 0x0FFFF byte.
SASL_OPTION_SEND_SIZE
 Jenis data buffer: ULONG

Ukuran data pesan maksimum yang dapat ditransmisikan. Nilai ini adalah ukuran buffer maksimum yang dapat ditransmisikan ke proses SASL jarak jauh dikurangi ukuran blok, ukuran trailer, dan ukuran tanda tangan maksimum. Nilai defaultnya adalah 0x0FFFF byte.

[in] Value

Penunjuk ke buffer yang berisi nilai untuk diatur ke properti yang diminta. Untuk jenis data buffer untuk setiap nilai parameter Opsi , lihat parameter Opsi .

[in] Size

Ukuran, dalam byte, dari buffer yang ditentukan oleh parameter Nilai .

Nilai kembali

Jika panggilan berhasil diselesaikan, fungsi ini mengembalikan SEC_E_OK. Tabel berikut ini memperlihatkan beberapa kemungkinan nilai pengembalian kesalahan.

Menampilkan kode Deskripsi
SEC_E_BUFFER_TOO_SMALL
 Buffer yang ditentukan oleh parameter Nilai tidak cukup besar untuk berisi nilai data properti yang ditentukan oleh parameter Opsi .
SEC_E_INVALID_HANDLE
 Handel konteks SASL yang ditentukan oleh parameter ContextHandle tidak ditemukan dalam daftar SASL.
SEC_E_UNSUPPORTED_FUNCTION
 Opsi yang ditentukan dalam parameter Opsi tidak valid.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header sspi.h (termasuk Security.h)
Pustaka Secur32.lib
DLL Secur32.dll