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
このパラメーターの値は、ビットごとのOR 演算と組み合わせて、次の値の 0 個以上にすることができます。
[out] Count
Credentials 配列で返された資格情報の数。
[out] Credential
資格情報へのポインターの配列へのポインター。
返される資格情報は、1 つの割り当てられたブロックです。 バッファー内に含まれるポインターは、この 1 つの割り当てられたブロック内の場所へのポインターです。 CredFree
戻り値
この関数は、成功した場合
戻りコード/値 | 形容 |
---|---|
|
指定した Filterと一致する資格情報が存在しません。 |
|
ログオン セッションが存在しないか、このログオン セッションに関連付けられている資格情報セットがありません。 ネットワーク ログオン セッションには、関連付けられた資格情報セットがありません。 |
|
無効なフラグが |
備考
手記
wincred.h ヘッダーは CredEnumerate をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wincred.h |
ライブラリ | Advapi32.lib |
DLL | Advapi32.dll |
関連項目
GetLastError の