fonction PifMgr_OpenProperties (shlobj_core.h)

Article
08/26/2023

[PifMgr_OpenProperties est disponible dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Ouvre le fichier .pif associé à une application Microsoft MS-DOS et retourne un handle aux propriétés de l’application.

Syntaxe

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

Paramètres

[in] pszApp

Type : PCWSTR

Chaîne Unicode terminée par null qui contient le nom de l’application.

[in, optional] pszPIF

Type : PCWSTR

Chaîne Unicode terminée par null qui contient le nom du fichier .pif.

hInf

Type : UINT

Handle du fichier .inf de l’application. Définissez cette valeur sur zéro s’il n’existe aucun fichier .inf. Définissez cette valeur sur -1 pour empêcher le traitement du fichier .inf.

flOpt

Type : UINT

Indicateur qui contrôle le fonctionnement de la fonction.

OPENPROPS_INHIBITPIF

Ignorez tous les fichiers .pif existants et obtenez les propriétés de win.ini ou _Default.pif. Cet indicateur est ignoré sur Windows NT, Windows 2000 et Windows XP.

OPENPROPS_NONE

Aucune option spécifiée.

Valeur retournée

Type : HANDLE

Retourne un handle aux propriétés de l’application. Utilisez ce handle lorsque vous appelez les fonctions .pif associées.

Remarques

Vous ne devez pas considérer PifMgr_OpenProperties comme une fonction qui ouvre un fichier quelque part. Le fichier .pif ne reste pas ouvert après cet appel. Il est plus utile de considérer la fonction comme un allocateur de structure de propriétés que vous pouvez initialiser à l’aide de données de disque. La principale raison pour laquelle cette fonction échoue est due à une mémoire insuffisante ou à l’impossibilité d’ouvrir le fichier .pif spécifié.

Si aucun fichier .pif n’existe, la fonction alloue toujours un bloc de données en mémoire et l’initialise avec les données de _Default.pif ou de ses valeurs par défaut internes. Si la fonction recherche un nom de fichier .pif mais ne le trouve pas, elle construit un nom et l’enregistre dans sa structure de données .pif interne. Cela garantit que si PifMgr_SetProperties est appelé, les données sont enregistrées sur le disque.

Si la fonction ne trouve pas le fichier .pif, elle le recherche dans l’ordre suivant.

Recherche dans le répertoire actif.
Recherche le répertoire spécifié.
Recherche dans le répertoire .pif.
Recherche les dossiers spécifiés par la variable d’environnement PATH.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

PifMgr_CloseProperties

PifMgr_GetProperties

Partager via