IVssWMFiledesc::GetPath メソッド (vswriter.h)

GetPath メソッドは、完全修飾ディレクトリ パスまたはリモート ファイル共有の UNC パスを取得して、現在の IVssWMFiledesc オブジェクトに記述されているファイルの一覧を取得します。

クエリ メソッドでは、このパスとファイル仕様を使用して、現在の IVssWMFiledesc オブジェクトを 返しました。

構文

HRESULT GetPath(
  [out] BSTR *pbstrPath
);

パラメーター

[out] pbstrPath

完全修飾ディレクトリ パスまたはリモート ファイル共有ディレクトリの UNC パスを指定する NULL で終わるワイド文字列を受け取る呼び出し元によって割り当てられた変数のアドレス。

パスには、長いファイル名または短いファイル名を指定でき、プレフィックス "\?" を使用できます。 詳細については、ファイルの名前つけに関する記事を参照してください。

このメソッドのユーザーはチェックして、このパスが円記号 ("") で終わるかどうかを判断する必要があります。

戻り値

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

値	説明
S_OK	パス情報が正常に返されました。
E_INVALIDARG	パラメーター値の 1 つが無効です。
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が使用されます。

解説

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP、Windows Server 2003: リモート ファイル共有は、Windows 8 および Windows Server 2012 まではサポートされません。

呼び出し元は、pbstrPath パラメーターによって保持されているメモリを解放するために SysFreeString を呼び出す必要があります。

要件

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

関連項目

IVssWMFiledesc