CredEnumerateA 関数 (wincred.h)
CredEnumerate 関数は、ユーザーの資格情報セットから資格情報を列挙します。 使用される資格情報セットは、現在のトークンのログオン セッションに関連付けられている資格情報セットです。 トークンでユーザーの SID が無効にされていない必要があります。
構文
BOOL CredEnumerateA(
[in] LPCSTR Filter,
[in] DWORD Flags,
[out] DWORD *Count,
[out] PCREDENTIALA **Credential
);
パラメーター
[in] Filter
返された資格情報のフィルターを含む null で終わる文字列へのポインター。 フィルターに一致する TargetName を持つ資格情報のみが返されます。 フィルターは、名前プレフィックスの後にアスタリスクを指定します。 たとえば、フィルター "FRED*" は、文字列 "FRED" で始まる TargetName を持つすべての資格情報を返します。
NULL を指定すると、すべての資格情報が返されます。
[in] Flags
このパラメーターの値は、次の値の 0 個以上をビットごとの OR 演算と組み合わせて使用できます。
[out] Count
Credentials 配列で返される 資格情報の 数。
[out] Credential
資格情報へのポインターの配列へのポインター。 返される資格情報は、1 つの割り当て済みブロックです。 バッファー内に含まれるポインターは、この 1 つの割り当て済みブロック内の場所へのポインターです。 返される 1 つのバッファーは、 CredFree を呼び出すことによって解放する必要があります。
戻り値
関数は、成功した場合は TRUE 、失敗した場合は FALSE を 返します。 GetLastError 関数を呼び出して、より具体的な状態コードを取得できます。 次の状態コードを返すことができます。
| リターン コード/値 | Description |
|---|---|
|
指定した フィルターに一致する資格情報が存在しません。 |
|
ログオン セッションが存在しないか、このログオン セッションに関連付けられている資格情報セットがありません。 ネットワーク ログオン セッションには、関連付けられた資格情報セットがありません。 |
|
無効なフラグが Flags パラメーターに指定されたか、Flags パラメーターにCRED_ENUMERATE_ALL_CREDENTIALSが指定され、FilterパラメーターがNULL ではありません。 |
注釈
注意
wincred.h ヘッダーは CredEnumerate をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | wincred.h |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |