IVssSoftwareSnapshotProvider::Query メソッド (vsprov.h)

  • [アーティクル]

プロバイダーが完了したシャドウ コピーに関する情報をプロバイダーに照会します。

構文

HRESULT Query(
  [in]  VSS_ID          QueriedObjectId,
  [in]  VSS_OBJECT_TYPE eQueriedObjectType,
  [in]  VSS_OBJECT_TYPE eReturnedObjectsType,
  [out] IVssEnumObject  **ppEnum
);

パラメーター

[in] QueriedObjectId

システムで使用するために予約されています。 このパラメーターの値はGUID_NULLする必要があります。

[in] eQueriedObjectType

システムで使用するために予約されています。 このパラメーターの値はVSS_OBJECT_NONEする必要があります。

[in] eReturnedObjectsType

システムで使用するために予約されています。 このパラメーターの値はVSS_OBJECT_SNAPSHOTする必要があります。

[out] ppEnum

返されるときに初期化される IVssEnumObject インターフェイス ポインターのアドレス。 呼び出し元はインターフェイスを解放する必要があります。 このパラメーターは必須であり、null にすることはできません。

戻り値

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

値 説明
S_OK
 クエリ操作が成功しました。
E_ACCESSDENIED
 呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_PROVIDER_VETO
 プロバイダー エラー。 プロバイダーがイベント ログにエラーを記録しました。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

解説

ppEnum パラメーターは、各シャドウ コピーのVSS_SNAPSHOT_PROP構造体を含むVSS_OBJECT_PROP構造体を返しますが、返される IVssEnumObject インターフェイスでIVssEnumObject::Next メソッドを呼び出します。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vsprov.h
Library VssApi.lib

関連項目

IVssSoftwareSnapshotProvider