次の方法で共有

CredGetTargetInfoA 関数 (wincred.h)

  • [アーティクル]

CredGetTargetInfo 関数は、名前付きターゲット コンピューターのすべての既知のターゲット名情報を取得します。 これはローカルで実行され、特定の特権は必要ありません。 返される情報は、CredReadDomainCredentials に渡され、CredWriteDomainCredentials 関数 渡されることが想定されています。 この情報は、他の目的には使用しないでください。

認証パッケージは、TargetNameに対する認証を試みるとき、TargetInfo を計算します。 認証パッケージは、このターゲット情報をキャッシュして、credGetTargetInfo使用できるようにします。 したがって、ターゲット情報は、TargetNameの認証を最近試行した場合にのみ使用できます。

LSA プロセスに含まれていない認証パッケージは、CRED_CACHE_TARGET_INFORMATION フラグを指定して CredReadDomainCredentials 呼び出すことによって、CredGetTargetInfo を して後で取得できるように、TargetInfo をキャッシュできます。

構文

BOOL CredGetTargetInfoA(
  [in]  LPCSTR                          TargetName,
  [in]  DWORD                           Flags,
  [out] PCREDENTIAL_TARGET_INFORMATIONA *TargetInfo
);

パラメーター

[in] TargetName

情報を取得する対象のコンピューターの名前を含む null で終わる文字列へのポインター。

[in] Flags

関数の操作を制御するフラグ。 次のフラグを使用できます。

CRED_ALLOW_NAME_RESOLUTION

TargetName 名前解決 ターゲット情報が見つからない場合は、TargetName で他のフォームに変換します。 これらの他の形式のいずれかに対してターゲット情報が存在する場合は、その情報が返されます。 現在、DNS の名前解決のみが行われています。

これは、アプリケーションが認証パッケージを直接呼び出さない場合に便利です。 アプリケーションは、TargetName を別のソフトウェア層に渡してサーバーに対して認証を行うことができます。また、そのレイヤーのソフトウェアによって名前が解決され、解決された名前が認証パッケージに渡される場合があります。 そのため、元の TargetNameのターゲット情報はありません。

[out] TargetInfo

ターゲット情報を格納するために割り当てられた 1 つのブロック バッファーへのポインター。 TargetInfo の返されるメンバーの少なくとも 1 つが NULL 以外になります。 バッファー内に含まれるポインターは、この 1 つの割り当てられたブロック内の場所へのポインターです。 CredFree呼び出すことによって、返される単一のバッファーを解放する必要があります。

戻り値

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

  • ERROR_NOT_FOUND

    名前付きサーバーのターゲット情報は使用できません。

備考

手記

wincred.h ヘッダーは CredGetTargetInfo をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wincred.h
ライブラリ Advapi32.lib
DLL Advapi32.dll

関連項目

CredFree

CredReadDomainCredentials の

CredWriteDomainCredentials の

GetLastError の