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 つの割り当て済みブロック内の場所へのポインターです。 返される 1 つのバッファーは、 CredFree を呼び出すことによって解放する必要があります。

戻り値

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

• ERROR_NOT_FOUND

  指定した TargetName の資格情報が存在しません。

• ERROR_NO_SUCH_LOGON_SESSION

  ログオン セッションが存在しないか、このログオン セッションに関連付けられている資格情報セットがありません。 ネットワーク ログオン セッションには、関連付けられた資格情報セットがありません。

• ERROR_INVALID_FLAGS

  無効なフラグが Flags パラメーターに指定されました。

注釈

Credential パラメーターで指定された CREDENTIAL 構造体の Type メンバーの値がCRED_TYPE_DOMAIN_EXTENDED場合は、ターゲット名に名前空間を指定する必要があります。 この関数は、指定した型の資格情報を 1 つだけ返すことができます。

要件