IPersistFileFormat.GetCurFile(String, UInt32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает путь к текущему выполняемому файлу объекта или, если текущий выполняемый файл отсутствует, выдаваемый по умолчанию запрос имени файла объекта.
public:
int GetCurFile([Runtime::InteropServices::Out] System::String ^ % ppszFilename, [Runtime::InteropServices::Out] System::UInt32 % pnFormatIndex);
int GetCurFile([Runtime::InteropServices::Out] std::wstring const & & ppszFilename, [Runtime::InteropServices::Out] unsigned int & pnFormatIndex);
public int GetCurFile (out string ppszFilename, out uint pnFormatIndex);
abstract member GetCurFile : string * uint32 -> int
Public Function GetCurFile (ByRef ppszFilename As String, ByRef pnFormatIndex As UInteger) As Integer
Параметры
- ppszFilename
- String
[out] Указатель на имя файла. Если объект имеет допустимое имя файла, то имя файла возвращается в качестве ppszFilename выходного параметра. Если объект находится в состоянии без заголовка, null то возвращается в качестве ppszFilename выходного параметра.
Обратите внимание, что этот результат отличается от стандартного GetCurFile(String) метода, который возвращает S_FALSE строку запроса "Сохранить как".
- pnFormatIndex
- UInt32
[out] Значение, которое показывает текущий формат файла. Это значение интерпретируется как начинающийся от нуля индекс в списке форматов, в соответствии с тем, что возвращает вызов метода GetFormatList(String). Значение индекса 0 указывает первый формат, 1 — второй формат и т. д. Если объект поддерживает только один формат, возвращается нуль. После этого он возвращает один элемент в его списке форматов через вызов GetFormatList(String).
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из фпстфмт. IDL:
HRESULT IPersistFileFormat::GetCurFile(
[out] LPOLESTR *ppszFilename,
[out] DWORD *pnFormatIndex
);
Этот метод аналогичен GetCurFile. Чтобы сохранить текущий файл в текущем формате, вызовите метод, GetCurFile чтобы получить значение текущего индекса формата, чтобы передать его правильно для Save метода.