CredWriteW

ユーザーの資格情報セットに新しい資格情報を作成するか、既存の資格情報を変更する。(Unicode)

CredWriteW Credential, Flags

Credential : [var] 書き込む CREDENTIAL 構造体へのポインタ。
Flags : [int] 関数の動作を制御するフラグ。以下のフラグが定義されている。

(プラグイン / モジュール : advapi32.dll)

解説

ユーザーの資格情報セットに新しい資格情報を作成するか、既存の資格情報を変更する。(Unicode)

[戻り値]
関数が成功した場合は TRUE を返す。失敗した場合は FALSE を返す。より詳細なステータスコードを取得するには
GetLastError 関数を呼び出す。以下のステータスコードが返される可能性がある。CRED_TYPE_CERTIFICATE
資格情報を書き込むとき、他にもスマートカードのエラーが返されることがある。
（以下省略）

[備考]
この関数は、指定された TargetName と Type を持つ資格情報が存在しない場合に資格情報を作成する。指定された
TargetName と Type を持つ資格情報が既に存在する場合、新しい資格情報が既存のものを置き換える。この関数が
CRED_TYPE_CERTIFICATE 資格情報を書き込むとき、Credential->CredentialBlob メンバは
Credential->UserName メンバで指定される証明書の秘密鍵を保護する PIN を指定する。資格情報マネージャは PIN
を保持しない。代わりに、PIN は証明書に示される暗号化サービスプロバイダ (CSP) に渡され、その後 CSP
と認証パッケージで使用される。CSP が PIN の有効期間を定義する。ほとんどの CSP
はスマートカードがスマートカードリーダーから取り外された時点で PIN を破棄する。Credential パラメータで指定される
CREDENTIAL 構造体の Type メンバが CRED_TYPE_DOMAIN_EXTENDED
である場合、ターゲット名に名前空間を指定する必要がある。この関数はワイルドカードを含むターゲット名への書き込みをサポートしない。
> [!NOTE] > wincred.h ヘッダーは CredWrite をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode
版を自動的に選択する。エンコーディングに依存しないエイリアスと、エンコーディングに依存しないコードとを混在させると、コンパイルエラーや実行時エラーを引き起こす不整合が生じる可能性がある。詳細は
[関数プロトタイプの規約](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報