Fungsi SaslGetContextOption (sspi.h)

  • Artikel

Fungsi SaslGetContextOption mengambil properti yang ditentukan dari konteks SASL yang ditentukan.

Sintaks

SECURITY_STATUS SEC_ENTRY SaslGetContextOption(
  [in]            PCtxtHandle ContextHandle,
  [in]            ULONG       Option,
  [out]           PVOID       Value,
  [out]           ULONG       Size,
  [out, optional] PULONG      Needed
);

Parameter

[in] ContextHandle

Menangani konteks SASL.

[in] Option

Properti untuk dikembalikan dari konteks SASL. Tabel berikut ini 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.
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.
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.

[out] Value

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

[out] Size

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

[out, optional] Needed

Penunjuk ke nilai LONG yang tidak ditandatangani yang mengembalikan nilai jika buffer yang ditentukan oleh parameter Nilai tidak cukup besar untuk berisi nilai data properti yang ditentukan oleh parameter Opsi .

Mengembalikan nilai

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

   
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