次の方法で共有


SetCredentialsAttributesA 関数 (sspi.h)

資格情報に関連付けられた名前など、資格情報属性を設定します。 この情報は、指定された資格情報で作成 セキュリティ コンテキストに対して有効です。

構文

SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesA(
  [in] PCredHandle   phCredential,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
       unsigned long cbBuffer
);

パラメーター

[in] phCredential

設定する資格情報のハンドル。

[in] ulAttribute

設定する 属性 を指定します。 このパラメーターには、次のいずれかの属性を指定できます。

価値 意味
SECPKG_CRED_ATTR_NAMES
SecPkgCredentials_Names型の pBuffer パラメーター内の資格情報の名前を設定します。

この属性は、WOW64 モードの Schannel ではサポートされていません。

SECPKG_CRED_ATTR_KDC_PROXY_SETTINGS
SecPkgCredentials_KdcProxySettings型の pBuffer パラメーターに Kerberos プロキシ設定を設定します。

この属性は Kerberos でのみサポートされています。

SECPKG_ATTR_SUPPORTED_ALGS
SecPkgCred_SupportedAlgs型の pBuffer パラメーターでサポートされているアルゴリズムを設定します。 提供された証明書でサポートされているか、ローカル コンピューターで有効になっているかに関係なく、サポートされているすべてのアルゴリズムが含まれます。

この属性は、Schannel でのみサポートされます。

SECPKG_ATTR_CIPHER_STRENGTHS
SecPkgCred_CipherStrengths型の pBuffer パラメーターの暗号強度を設定します。

この属性は、Schannel でのみサポートされます。

SECPKG_ATTR_SUPPORTED_PROTOCOLS
SecPkgCred_SupportedProtocols型の pBuffer パラメーターでサポートされているアルゴリズムを設定します。 指定された証明書でサポートされているか、ローカル コンピューターで有効になっているかに関係なく、サポートされているすべてのプロトコルが含まれます。

この属性は、Schannel でのみサポートされます。

[in] pBuffer

新しい属性値を含むバッファーへのポインター。 返される構造体の型は、ulAttributeの値 依存します。

cbBuffer

pBuffer バッファーのサイズ (バイト単位)。

戻り値

関数が成功した場合、戻り値はSEC_E_OK。

関数が失敗した場合、戻り値は次のいずれかのエラー コードである可能性があります。

リターン コード 形容
SEC_E_INVALID_HANDLE
関数に渡されたハンドルが無効です。
SEC_E_UNSUPPORTED_FUNCTION
指定した 属性 は、Schannel ではサポートされていません。 この戻り値は、Schannel SSP が使用されている場合にのみ返されます。
SEC_E_INSUFFICIENT_MEMORY
要求を完了するのに十分なメモリがありません。

備考

手記

sspi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetCredentialsAttributes を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー sspi.h (Security.h を含む)
ライブラリ Secur32.lib
DLL Secur32.dll

関連項目

AcquireCredentialsHandle

FreeContextBuffer の

SCH_CREDENTIALS

SSPI 関数の

SecPkgCred_CipherStrengths

SecPkgCred_SupportedAlgs

SecPkgCred_SupportedProtocols

SecPkgCredentials_Names