Partager via


PifMgr_SetProperties, fonction (shlobj_core.h)

[PifMgr_SetProperties 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.]

Affecte des valeurs à un bloc de données à partir d’un fichier .pif.

Syntaxe

int PifMgr_SetProperties(
  [in, optional] HANDLE     hProps,
  [in, optional] PCSTR      pszGroup,
  [in]           const void *lpProps,
                 int        cbProps,
                 UINT       flOpt
);

Paramètres

[in, optional] hProps

Type : HANDLE

Handle des propriétés de l’application. Ce paramètre doit être défini sur la valeur retournée par PifMgr_OpenProperties.

[in, optional] pszGroup

Type : PCSTR

Chaîne ANSI terminée par un caractère Null contenant 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 »

[in] lpProps

Type : const void*

Mémoire tampon d’enregistrement de groupe de propriétés qui contient les données.

cbProps

Type : int

Taille de la mémoire tampon, en octets, pointée par lpProps.

flOpt

Type : UINT

Toujours SETPROPS_NONE.

Valeur retournée

Type : int

Retourne la quantité d’informations transférées, en octets. Retourne zéro si le groupe est introuvable ou si une erreur se produit.

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_GetProperties