SaslSetContextOption 函式 (sspi.h)

  • 發行項

SaslSetContextOption 函式會設定指定 SASL 內容的指定屬性值。

語法

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

參數

[in] ContextHandle

SASL 內容的句柄。

[in] Option

要為 SASL 內容設定的屬性。 下表列出可能的值。

值 意義
SASL_OPTION_AUTHZ_PROCESSING
 緩衝區的數據類型： ULONG

SASL 應用程式的 Authz 值處理狀態。 處理的有效狀態Sasl_AuthZIDForbidden和Sasl_AuthZIDProcessed。 預設值為 Sasl_AuthZIDProcessed。
SASL_OPTION_AUTHZ_STRING
 緩衝區的數據類型：二進位字元陣列

從SASL用戶端傳遞至伺服器的字元字串。 如果AuthZ_Processing狀態Sasl_AuthZIDForbidden，則會傳回傳回值SEC_E_UNSUPPORTED_FUNCTION。
SASL_OPTION_RECV_SIZE
 緩衝區的數據類型： ULONG

本機電腦上的接收緩衝區大小上限。 預設值為0x0FFFF位元組。
SASL_OPTION_SEND_SIZE
 緩衝區的數據類型： ULONG

可以傳輸的訊息數據大小上限。 此值是可以傳輸至遠端 SASL 進程的最大緩衝區大小減去區塊大小、預告片大小和簽章大小上限。 預設值為0x0FFFF位元組。

[in] Value

緩衝區的指標，其中包含要設定為所要求屬性的值。 如需 Option 參數之每個值的緩衝區數據類型，請參閱 Option 參數。

[in] Size

Value 參數所指定的緩衝區大小，以位元組為單位。

傳回值

如果呼叫成功完成，此函式會傳回SEC_E_OK。 下表顯示一些可能的錯誤傳回值。

傳回碼 Description
SEC_E_BUFFER_TOO_SMALL
 Value 參數指定的緩衝區不夠大，足以包含Option參數所指定之屬性的數據值。
SEC_E_INVALID_HANDLE
 在 SASL 清單中找不到 ContextHandle 參數指定的 SASL 內容句柄。
SEC_E_UNSUPPORTED_FUNCTION
 Option 參數中指定的選項無效。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 sspi.h (包含 Security.h)
程式庫 Secur32.lib
Dll Secur32.dll