SetCredentialsAttributesW 関数 (sspi.h)
資格情報に関連付けられている名前など、資格情報の属性を設定します。 この情報は、指定された資格情報で作成されたすべての セキュリティ コンテキスト に対して有効です。
構文
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesW(
[in] PCredHandle phCredential,
[in] unsigned long ulAttribute,
[in] void *pBuffer,
unsigned long cbBuffer
);
パラメーター
[in] phCredential
設定する資格情報のハンドル。
[in] ulAttribute
設定する 属性 を指定します。 このパラメーターには、次のいずれかの属性を指定できます。
| 値 | 意味 |
|---|---|
|
SecPkgCredentials_Names 型の pBuffer パラメーター内の資格情報の名前 を設定します。
この属性は、WOW64 モードの Schannel ではサポートされていません。 |
|
SecPkgCredentials_KdcProxySettings型の pBuffer パラメーターで Kerberos プロキシ設定 を設定します。
この属性は Kerberos でのみサポートされています。 |
|
SecPkgCred_SupportedAlgs型の pBuffer パラメーターでサポートされているアルゴリズム を設定します。 サポートされているすべてのアルゴリズムは、指定された証明書でサポートされているか、ローカル コンピューターで有効になっているかに関係なく含まれます。
この属性は、Schannel でのみサポートされています。 |
|
SecPkgCred_CipherStrengths型の pBuffer パラメーターに暗号強度 を設定します。
この属性は、Schannel でのみサポートされています。 |
|
SecPkgCred_SupportedProtocols 型の pBuffer パラメーターでサポートされているアルゴリズム を設定します。 サポートされているすべてのプロトコルは、指定された証明書でサポートされているか、ローカル コンピューターで有効になっているかに関係なく含まれます。
この属性は、Schannel でのみサポートされています。 |
[in] pBuffer
新しい属性値を含むバッファーへのポインター。 返される構造体の型は、 ulAttribute の値によって異なります。
cbBuffer
pBuffer バッファーのサイズ (バイト単位)。
戻り値
関数が成功した場合、戻り値はSEC_E_OK。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
関数に渡されたハンドルが無効です。 |
|
指定した 属性 は、Schannel ではサポートされていません。 この戻り値は、Schannel SSP が使用されている場合にのみ返されます。 |
|
要求を完了するのに十分なメモリがありません。 |
注釈
注意
sspi.h ヘッダーは、SetCredentialsAttributes をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | sspi.h (Security.h を含む) |
| Library | Secur32.lib |
| [DLL] | Secur32.dll |