CredWriteDomainCredentialsW

ユーザーの資格情報セットにドメイン資格情報を書き込む。(Unicode)

CredWriteDomainCredentialsW TargetInfo, Credential, Flags

TargetInfo : [var] 対象サーバを識別する。命名メンバのうち少なくとも 1 つは NULL 以外でなければならず、NetbiosServerName、DnsServerName、NetbiosDomainName、DnsDomainName、DnsTreeName のいずれかとなる。
Credential : [var] 書き込む資格情報。
Flags : [int] API の動作を制御するフラグ。以下のフラグが定義されている。

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

解説

ユーザーの資格情報セットにドメイン資格情報を書き込む。(Unicode)

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

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

情報