PifMgr_GetProperties, fonction (shlobj_core.h)
[PifMgr_GetProperties 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.]
Retourne un bloc de données spécifié à partir d’un fichier .pif.
Syntaxe
int PifMgr_GetProperties(
[in, optional] HANDLE hProps,
[in, optional] PCSTR pszGroup,
[out, optional] void *lpProps,
int cbProps,
UINT flOpt
);
Paramètres
[in, optional] hProps
Type : HANDLE
Handle pour les propriétés d’une application. Ce paramètre doit être défini sur la valeur retournée par PifMgr_OpenProperties.
[in, optional] pszGroup
Type : PCSTR
Chaîne terminée par null qui contient le nom du groupe de propriétés. Il peut s’agir de l’un des noms suivants ou de tout autre nom qui correspond à une extension .pif valide.
« WINDOWS 286 3.0 »
« WINDOWS 386 3.0 »
« WINDOWS VMM 4.0 »
« WINDOWS NT 3.1 »
« WINDOWS NT 4.0 »
[out, optional] lpProps
Type : void*
Lorsque cette fonction est retournée, contient un pointeur vers une structure PROPPRG .
cbProps
Type : int
Taille de la mémoire tampon, en octets, pointée par lpProps.
flOpt
Type : UINT
Définissez ce paramètre sur GETPROPS_NONE.
Valeur retournée
Type : int
Retourne NULL en cas de réussite. En cas d’échec, la fonction retourne le handle aux propriétés d’application qui ont été passées en tant que hProps.
Remarques
Si le bloc est un bloc « nommé », il doit s’agir du nom d’une extension liée à l’intérieur du fichier .pif. Il peut s’agir de n’importe quel nom prédéfini (par exemple, « WINDOWS 386 3.0 ») ou du nom de votre propre bloc. Vous pouvez créer vos propres blocs de données nommés à l’aide de PifMgr_SetProperties. Les données nommées peuvent également être considérées comme des données brutes, car elles sont retournées à l’application appelante telle qu’elle est, sans traduction.
La taille d’un bloc nommé peut être déterminée en appelant PifMgr_GetProperties avec cbProps défini sur 0. Aucune donnée n’est copiée, mais la taille du bloc demandé est retournée.
Tous les blocs nommés peuvent être énumérés en définissant pszGroup sur NULL. lpProps doit être un pointeur vers une mémoire tampon de 16 octets pour contenir le nom de bloc demandé, et cbProps doit être défini sur l’index de bloc de base zéro. La valeur de retour est la taille du bloc, ou zéro si le bloc est introuvable.
Si vous demandez un bloc de propriété sans nom en affectant la valeur NULL au sélecteur du paramètre name et que le décalage est un ordinal de groupe de propriétés, la structure associée est retournée. Par exemple, PifMgr_GetProperties(GROUP_TSK) retourne une structure prédéfinie qui contient toutes les informations relatives aux tâches dans un format indépendant du fichier .pif. Il s’agit d’un service précieux, car il évite aux applications appelantes de traiter des fichiers .pif qui contiennent une grande variété de sections (appelées extensions .pif), quand une seule est nécessaire.
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) |