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
 ContextHandle パラメーターで指定された SASL コンテキスト ハンドルが SASL リストに見つかりませんでした。
SEC_E_UNSUPPORTED_FUNCTION
 Option パラメーターで指定された オプション が無効です。

要件

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