IVssWMDependency::GetLogicalPath メソッド (vswriter.h)

  • [アーティクル]

GetLogicalPath メソッドは、現在のコンポーネントが依存するコンポーネントの論理パスを明示的なライター コンポーネントの依存関係で取得します。

構文

HRESULT GetLogicalPath(
  [out] BSTR *pbstrLogicalPath
);

パラメーター

[out] pbstrLogicalPath

現在のコンポーネントが依存するコンポーネントの論理パスを含む NULL で終わるワイド文字列を受け取る呼び出し元によって割り当てられた変数のアドレス。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 意味
S_OK
 現在のコンポーネントが依存しているコンポーネントの論理パスが正常に返されました。
S_FALSE
 現在のコンポーネントが依存するコンポーネントを管理するライターが見つかりません。
E_INVALIDARG
 ポインター pbstrLogicalPath は、未割り当てメモリを指します。
E_OUTOFMEMORY
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_INVALID_XML_DOCUMENT
 XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。

注釈

呼び出し元は 、SysFreeString を呼び出して、返された文字列で使用されるメモリを解放する必要があります。

依存関係は、文書化された依存関係を持つコンポーネントと依存するコンポーネントの間の優先順位を示すものではありません。 依存関係は、コンポーネントと依存するコンポーネントを常にバックアップまたは復元する必要があることを示しているだけです。

特定のライター クラスの複数のインスタンスを持つことができます。ただし、コンポーネントの論理パスと名前は一意である必要があります。

ライター クラスのインスタンスが複数ある場合は、論理パスとコンポーネント名の情報を使用して、現在のコンポーネントが依存しているコンポーネントを管理しているインスタンスを識別する必要があります。

要件

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

こちらもご覧ください

IVssWMComponent::GetDependency

IVssWMDependency

IVssWMDependency::GetComponentName

IVssWMDependency::GetWriterId