CredReadA 関数 (wincred.h)
CredRead 関数は、ユーザーの資格情報セットから資格情報を読み取ります。 使用される資格情報セットは、現在のトークンのログオン セッションに関連付けられている資格情報セットです。 トークンは、ユーザーの SID を無効にしてはなりません。
構文
BOOL CredReadA(
[in] LPCSTR TargetName,
[in] DWORD Type,
[in] DWORD Flags,
[out] PCREDENTIALA *Credential
);
パラメーター
[in] TargetName
読み取る資格情報の名前を含む null で終わる文字列へのポインター。
[in] Type
読み取る資格情報の種類。 型 は、CRED_TYPE_* 定義された型のいずれかである必要があります。
[in] Flags
現在予約されており、0 である必要があります。
[out] Credential
資格情報を返す、割り当てられた 1 つのブロック バッファーへのポインター。
バッファー内に含まれるポインターは、この 1 つの割り当てられたブロック内の場所へのポインターです。 CredFree
戻り値
この関数は、成功した場合
- ERROR_NOT_FOUND
指定した TargetNameを持つ資格情報が存在しません。
- ERROR_NO_SUCH_LOGON_SESSION
ログオン セッションが存在しないか、このログオン セッションに関連付けられている資格情報セットがありません。 ネットワーク ログオン セッションには、関連付けられた資格情報セットがありません。
- ERROR_INVALID_FLAGS
Flags パラメーターに無効なフラグが指定されました。
備考
Credential パラメーターで指定された CREDENTIAL 構造体の Type メンバーの値が CRED_TYPE_DOMAIN_EXTENDED場合は、ターゲット名に名前空間を指定する必要があります。 この関数は、指定した型の資格情報を 1 つだけ返すことができます。
手記
wincred.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CredRead を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wincred.h |
ライブラリ | Advapi32.lib |
DLL | Advapi32.dll |