IFhReassociation::GetConfigurationDetails メソッド (fhcfg.h)

このメソッドは、 IFhReassociation::ScanTargetForConfigurations メソッドによってストレージデバイスまたはネットワーク共有で検出されたファイル履歴構成を列挙し、検出された各構成に関する追加情報を返します。

注意

IFhReassociation は非推奨であり、今後のリリースでは変更または使用できない可能性があります。

構文

HRESULT GetConfigurationDetails(
  [in]  DWORD    Index,
  [out] BSTR     *UserName,
  [out] BSTR     *PcName,
  [out] FILETIME *BackupTime
);

[in] Index

検出された構成の 0 から始まるインデックス。

[out] UserName

戻り時に、には、構成が最後にバックアップされたユーザーアカウントの名前を含む SysAllocString で割り当てられた文字列へのポインターが含まれます。

[out] PcName

戻り時に、には、構成が最後にバックアップされたコンピューターの名前を含む SysAllocString で割り当てられた文字列へのポインターが含まれます。

[out] BackupTime

戻り時に、には、構成が最後にバックアップされた日時が含まれます。

成功した場合はS_OK 、失敗した場合は 失敗した HRESULT 。失敗した 可能性のある HRESULT 値には、FhErrors.h ヘッダーファイルで定義されている値が含まれます。

指定したインデックスを持つファイル履歴構成がない場合は、 HRESULT_FROM_WIN32(ERROR_NOT_FOUND) エラーコードが返されます。

呼び出し元は、 UserName と PcName に割り当てられたメモリを解放するために、それぞれの SysFreeString を呼び出します。

再関連付けを実行するには、 IFhReassociation::SelectConfiguration メソッドを使用してこのメソッドによって列挙された構成の 1 つを選択してから、 IFhReassociation::P erformReassociation メソッドを呼び出す必要があります。