IVssWMComponent::GetDatabaseLogFile メソッド (vsbackup.h)

GetDatabaseLogFile メソッドは、指定されたデータベースバックアップコンポーネントに関連付けられているログファイルのファイル記述子を取得します。

構文

HRESULT GetDatabaseLogFile(
  [in]  UINT           iDbLogFile,
  [out] IVssWMFiledesc **ppFiledesc
);

[in] iDbLogFile

0 ~ n-1 の間のオフセット。n は、IVssWMComponent::GetComponentInfo によって返されるVSS_COMPONENTINFO オブジェクトの cLogFiles メンバーによって指定されたデータベースログファイルの数です。

[out] ppFiledesc

返されたファイル記述子情報を含む IVssWMFiledesc オブジェクトへの二重間接ポインター。

このメソッドの有効なリターンコードを次に示します。

値	意味
S_OK	IVssWMFiledesc インターフェイスのインスタンスへのポインターが正常に返されました。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリ不足またはその他のシステムリソースです。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細については、イベントログを確認してください。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_OBJECT_NOT_FOUND	指定されたデータベースログファイルが存在しません。
VSS_E_UNEXPECTED	予期しないエラー。エラーコードはエラーログファイルに記録されます。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。代わりに、E_UNEXPECTEDが使用されます。

呼び出し元は、 IUnknown::Release を呼び出して、返された IVssWMFiledesc オブジェクトによって保持されているシステムリソースを解放する必要があります。

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む)
Library	VssApi.lib