Метод IBackgroundCopyFile::GetRemoteName (bits.h)

Извлекает удаленное имя файла.

Синтаксис

HRESULT GetRemoteName(
  [out] LPWSTR *pVal
);

Параметры

[out] pVal

Строка, завершающаяся значением NULL, содержащая удаленное имя передаваемого файла. Полное имя. По завершении вызовите функцию CoTaskMemFree , чтобы освободить ppName .

Возвращаемое значение

Этот метод возвращает S_OK об успешном выполнении или одно из стандартных значений COM HRESULT при ошибке.

Комментарии

Имя удаленного файла задается при вызове методов AddFile или AddFileSet интерфейса IBackgroundCopyJob .

Чтобы изменить имя удаленного файла, вызовите метод IBackgroundCopyFile2::SetRemoteName или метод IBackgroundCopyJob3::ReplaceRemotePrefix .

Примеры

См. пример кода для метода IBackgroundCopyFile::GetLocalName .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Минимальная версия сервера	Windows Server 2003
Целевая платформа	Windows
Header	bits.h
Библиотека	Bits.lib
DLL	QmgrPrxy.dll

См. также раздел

IBackgroundCopyFile

IBackgroundCopyFile::GetLocalName

IBackgroundCopyJob::AddFile

IBackgroundCopyJob::AddFileSet