共用方式為

saslGetCoNtextOption 函式 (sspi.h)

  • 發行項

SaslGetCoNtextOption函式會擷取指定 SASL 內容的指定屬性。

語法

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

參數

[in] ContextHandle

SASL 內容的控制碼。

[in] Option

要從 SASL 內容傳回的屬性。 下表列出可能的值。

值 意義
SASL_OPTION_AUTHZ_PROCESSING
 緩衝區的資料類型： ULONG

SASL 應用程式所提供 Authz 值的 SASL 處理狀態。 處理的有效狀態Sasl_AuthZIDForbidden和Sasl_AuthZIDProcessed。
SASL_OPTION_AUTHZ_STRING
 緩衝區的資料類型：二進位字元陣列

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

本機電腦上的接收緩衝區大小上限。
SASL_OPTION_SEND_SIZE
 緩衝區的資料類型： ULONG

可以傳輸的訊息資料大小上限。 此值是可以傳輸至遠端 SASL 進程的最大緩衝區大小減去區塊大小、預告片大小和簽章大小上限。

[out] Value

接收所要求屬性之緩衝區的指標。 如需 Option 參數每個值的緩衝區資料類型，請參閱 Option 參數。

[out] Size

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

[out, optional] Needed

如果Value參數指定的緩衝區不足以包含Option參數所指定屬性的資料值，則為不帶正負號LONG值的指標，傳回值。

傳回值

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

傳回碼 描述
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