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 処理の状態。 処理の有効な状態は、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を返します。 次の表は、エラーの戻り値の可能性を示しています。

リターン コード 説明
SEC_E_BUFFER_TOO_SMALL
 Value パラメーターで指定されたバッファーは、Option パラメーターで指定されたプロパティのデータ値を格納するのに十分な大きさではありません。
SEC_E_INVALID_HANDLE
 ContextHandle パラメーターで指定された SASL コンテキスト ハンドルが SASL リストに見つかりませんでした。
SEC_E_UNSUPPORTED_FUNCTION
 Option パラメーターで指定された オプション が無効です。

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー sspi.h (Security.h を含む)
Library Secur32.lib
[DLL] Secur32.dll