IBackgroundCopyFile::GetRemoteName メソッド (bits.h)

ファイルのリモート名を取得します。

構文

HRESULT GetRemoteName(
  [out] LPWSTR *pVal
);

[out] pVal

転送するファイルのリモート名を含む Null で終わる文字列。名前は完全修飾です。完了したら、 CoTaskMemFree 関数を呼び出して ppName を 解放します。

このメソッドは、成功 した場合にS_OK を返すか、エラー時に標準の COM HRESULT 値のいずれかを返します。

リモートファイル名は、IBackgroundCopyJob インターフェイスの AddFile メソッドまたは AddFileSet メソッドを呼び出すときに設定されます。

リモートファイル名を変更するには、 IBackgroundCopyFile2::SetRemoteName メソッドまたは IBackgroundCopyJob3::ReplaceRemotePrefix メソッドを呼び出します。

IBackgroundCopyFile::GetLocalName メソッドのコード例を参照してください。