IFileDataRetriever::GetRelativeDirectoryPath

Возвращает путь к файлу относительно корневого каталога реплики.

HRESULT GetRelativeDirectoryPath(
  LPWSTR pszDirectoryPath,
  ULONG *pcchDirectoryPathLength);

Параметры

  • pszDirectoryPath
    [in, out, size_is(*pcchDirectoryPathLength)] Возвращает путь к файлу относительно корневого каталога реплики. Этот путь не должен начинаться с косой черты.
  • pcchDirectoryPathLength
    [in, out] Указывает длину pszDirectoryPath в символах. Возвращает число символов, необходимых для получения каталога, если размер pszDirectoryPath слишком мал, либо возвращает число записанных символов.

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

  • S_OK.

  • E_POINTER.

  • E_INVALIDARG.

  • HRESULT_FROM_WIN32(ERROR_MORE_DATA), если значение pszDirectoryPath слишком мало. В этом случае необходимое число символов возвращается в параметре pcchDirectoryPathLength.

Замечания

Чтобы получить полный относительный путь к файлу, объедините путь, возвращаемый в параметре pszDirectoryPath, с именем файла, содержащимся в значении WIN32_FIND_DATAW.cFileName, возвращаемом методом IFileDataRetriever::GetFileInfo.

Путь, возвращаемый в параметре pszDirectoryPath, задается относительно корневого каталога реплики. Он не должен начинаться с косой черты. Например, если этот метод вызывается для файла в корневом каталоге реплики, то параметр pszDirectoryPath содержит пустую строку ("").

См. также

Справочник

Интерфейс IFileDataRetriever