SetContextAttributesA 関数 (sspi.h)
トランスポート アプリケーションで、
構文
SECURITY_STATUS SEC_ENTRY SetContextAttributesA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[in] void *pBuffer,
[in] unsigned long cbBuffer
);
パラメーター
[in] phContext
設定するセキュリティ コンテキストへのハンドル。
[in] ulAttribute
設定するコンテキストの属性。 このパラメーターには、次のいずれかの値を指定できます。
| 価値 | 意味 |
|---|---|
|
pBuffer パラメーターには、SecPkgContext_SessionAppData 構造体へのポインターが含まれています。
セッションのアプリケーション データを設定します。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、SecPkgContext_EapPrfInfo 構造体へのポインターが含まれています。
拡張認証プロトコル (EAP) で使用される擬似ランダム関数 (PRF) を設定します。 これは、SECPKG_ATTR_EAP_KEY_BLOCK が ulAttribute パラメーターの値として渡されるときに、QueryContextAttributes (Schannel) 関数の呼び出しによって返される値です。 この属性は、Schannel セキュリティ パッケージでのみサポートされます。 |
|
pBuffer パラメーターには、SecPkgContext_EarlyStart 構造体へのポインターが含まれています。
False Start 機能を設定します。 この機能の詳細については、より高速で安全な Web の構築に関するブログ記事を参照してください。 |
|
DTLS で使用する MTU (最大伝送単位) 値を設定および取得します。
セキュリティ コンテキストで DTLS が有効になっていない場合、この属性はサポートされません。
有効な値は 200 バイトから 64 KB です。 Schannel の既定の DTLS MTU 値は 1096 バイトです。 |
|
pBuffer パラメーターには、SecPkgContext_KeyingMaterialInfo 構造体へのポインターが含まれています。 キーマテリアルエクスポート機能は、RFC 5705 標準 この属性は、Windows 10 および Windows Server 2016 以降のバージョンの Schannel セキュリティ パッケージでのみサポートされます。 |
[in] pBuffer
属性を設定する値を含む構造体へのポインター。 指す構造体の型は、ulAttribute パラメーターで指定された値によって異なります。
[in] cbBuffer
pBuffer パラメーターのサイズ (バイト単位)。
戻り値
関数が成功した場合、関数はSEC_E_OKを返します。
関数が失敗すると、0 以外のエラー コードが返されます。 次のエラー コードは、考えられるエラー コードの 1 つです。
| リターン コード | 形容 |
|---|---|
|
この値は、この関数がサポートされていないことを示すために、Schannel カーネル モードによって返されます。 |
備考
手記
sspi.h ヘッダーは、SetContextAttributes をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | sspi.h (Security.h を含む) |
| ライブラリ | Secur32.lib |
| DLL | Secur32.dll |