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 演算と組み合わせて使用できます。

値 意味
CRED_ENUMERATE_ALL_CREDENTIALS
0x1
 この関数は、ユーザーの資格情報セット内のすべての資格情報を列挙します。 各資格情報のターゲット名は、"namespace:attribute=target" 形式で返されます。 このフラグが設定され、 Filter パラメーターが NULL でない場合、関数は失敗し 、ERROR_INVALID_FLAGSを返します。

Windows Server 2003 および Windows XP: このフラグはサポートされていません。

[out] Count

Credentials 配列で返される 資格情報の 数。

[out] Credential

資格情報へのポインターの配列へのポインター。 返される資格情報は、1 つの割り当て済みブロックです。 バッファー内に含まれるポインターは、この 1 つの割り当て済みブロック内の場所へのポインターです。 返される 1 つのバッファーは、 CredFree を呼び出すことによって解放する必要があります。

戻り値

関数は、成功した場合は TRUE 、失敗した場合は FALSE を 返します。 GetLastError 関数を呼び出して、より具体的な状態コードを取得できます。 次の状態コードを返すことができます。

リターン コード/値 Description
ERROR_NOT_FOUND
1168 (0x490)
 指定した フィルターに一致する資格情報が存在しません。
ERROR_NO_SUCH_LOGON_SESSION
1312 (0x520)
 ログオン セッションが存在しないか、このログオン セッションに関連付けられている資格情報セットがありません。 ネットワーク ログオン セッションには、関連付けられた資格情報セットがありません。
ERROR_INVALID_FLAGS
1004 (0x3EC)
 無効なフラグが 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

こちらもご覧ください

CredFree

GetLastError