функция PifMgr_OpenProperties (shlobj_core.h)

Статья
08/26/2023

[PifMgr_OpenProperties доступно для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Открывает PIF-файл, связанный с приложением Microsoft MS-DOS, и возвращает дескриптор свойств приложения.

Синтаксис

HANDLE PifMgr_OpenProperties(
  [in]           PCWSTR pszApp,
  [in, optional] PCWSTR pszPIF,
                 UINT   hInf,
                 UINT   flOpt
);

Параметры

[in] pszApp

Тип: PCWSTR

Строка Юникода, завершающаяся null, которая содержит имя приложения.

[in, optional] pszPIF

Тип: PCWSTR

Строка Юникода с пустым завершением, содержащая имя PIF-файла.

hInf

Тип: UINT

Дескриптор INF-файла приложения. Установите для этого значения нулевое значение, если inf-файл отсутствует. Присвойте этому значению значение -1, чтобы предотвратить обработку INF-файла.

flOpt

Тип: UINT

Флаг, определяющий работу функции.

OPENPROPS_INHIBITPIF

Игнорируйте все существующие PIF-файлы и получите свойства из win.ini или _Default.pif. Этот флаг игнорируется в Windows NT, Windows 2000 и Windows XP.

OPENPROPS_NONE

Параметры не заданы.

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

Тип: HANDLE

Возвращает дескриптор свойств приложения. Используйте этот дескриптор при вызове связанных функций PIF.

Не следует думать о PifMgr_OpenProperties как о функции, которая где-то открывает файл. PIF-файл не остается открытым после этого вызова. Функцию удобнее рассматривать как распределитель структуры свойств, который можно инициализировать с помощью данных диска. Основная причина сбоя этой функции заключается в нехватке памяти или невозможности открыть указанный PIF-файл.

Если PIF-файл не существует, функция по-прежнему выделяет блок данных в памяти и инициализирует его данными из _Default.pif или внутренними значениями по умолчанию. Если функция ищет имя PIF-файла, но не находит его, она создает имя и сохраняет его во внутренней структуре данных PIF. Это гарантирует, что при вызове PifMgr_SetProperties данные будут сохранены на диск.

Если функция не находит PIF-файл, она ищет его в следующем порядке.

Выполняет поиск в текущем каталоге.
Выполняет поиск в указанном каталоге.
Выполняет поиск в каталоге .pif.
Выполняет поиск папок, указанных переменной среды PATH.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя)

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

PifMgr_CloseProperties

PifMgr_GetProperties

Поделиться через