IVssCreateWriterMetadata::AddComponentDependency メソッド (vswriter.h)

AddComponentDependency メソッドを使用すると、ライターは、それが管理するコンポーネントに明示的なライター コンポーネントの依存関係があることを示すことができます。つまり、別のライター内の別のコンポーネントをバックアップし、それを使用して復元する必要があります。

構文

HRESULT AddComponentDependency(
  [in] LPCWSTR wszForLogicalPath,
  [in] LPCWSTR wszForComponentName,
  [in] VSS_ID  onWriterId,
  [in] LPCWSTR wszOnLogicalPath,
  [in] LPCWSTR wszOnComponentName
);

パラメーター

[in] wszForLogicalPath

依存関係を必要とするコンポーネント (現在のライターによって管理される) の論理パスを含む null で終わるワイド文字列。

[in] wszForComponentName

依存関係を必要とする (現在のライターによって管理される) コンポーネントを含む null で終わるワイド文字列。

[in] onWriterId

現在のコンポーネントが依存するコンポーネントを管理するライターのクラス ID または VSS_ID (GUID)。

[in] wszOnLogicalPath

現在のコンポーネントが依存するコンポーネントの論理パス ( onWriterId によって識別されるライターによって管理されます)。

[in] wszOnComponentName

現在のコンポーネントが依存するコンポーネントの名前 ( onWriterId によって識別されるライターによって管理されます)。

戻り値

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

解説

現在のライターによって管理されているコンポーネントへの依存関係は許可されません。

依存関係では、依存関係のターゲットとターゲットに依存するコンポーネントの両方を復元して一緒にバックアップする必要があります。 コンポーネント間の優先順位は示されませんが、リクエスターはそれを実装することを選択できます。

論理名とコンポーネント名の組み合わせは、ライター クラスのすべてのインスタンスで一意である必要があるため、複数のライターが同じクラス ID を持つことは問題ではありません。

このメソッドを使用して、リモート依存関係を宣言できます。 ライターは、"\\RemoteComputerName" をプリペンドすることでリモート依存関係を宣言できます。 RemoteComputerName は、リモート コンポーネントが存在するコンピューターの名前を wszOnLogicalPath パラメーターの論理パスに指定します。 RemoteComputerName の値には、IP アドレスまたは GetComputerNameEx 関数によって返されるコンピューター名を指定できます。

リモート コンポーネントがクラスター上にある場合、ライターはクラスターの仮想名を報告する必要があります。ボリューム シャドウ コピーを作成する前に、仮想名をクラスター ノードの物理名にマップするのは要求者の責任です。

依存関係がローカルかリモートかを判断するには、要求者は pbstrComponentName パラメーターで返されるコンポーネント名を調べる必要があります。 コンポーネント名が "\" で始まる場合、要求者はリモート依存関係を指定し、"\" に続く最初のコンポーネントがライターによって指定された RemoteComputerName であると想定する必要があります。 コンポーネント名が "\" で始まらない場合、リクエスターはローカル依存関係を指定すると想定する必要があります。

Windows Server 2003: Windows Server 2003 Service Pack 1 (SP1) まで、このメソッドを使用してリモート依存関係を宣言することはできません。

要件