Fonction SHOpenPropSheetA (shlobj.h)

Article
03/04/2024

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

Crée une feuille de propriétés à partir d’une liste de clés de Registre contenant les CLSIDdes feuilles individuelles, puis ouvre la feuille de propriétés.

Syntaxe

BOOL SHOpenPropSheetA(
  [in, optional] LPCSTR        pszCaption,
  [in, optional] HKEY []       ahkeys,
                 UINT          ckeys,
  [in, optional] const CLSID   *pclsidDefault,
  [in]           IDataObject   *pdtobj,
  [in, optional] IShellBrowser *psb,
  [in, optional] LPCSTR        pStartPage
);

Paramètres

[in, optional] pszCaption

Type : LPCTSTR

Pointeur vers une chaîne qui contient les légende de la feuille de propriétés. Cette valeur peut être NULL si aucune légende n’est nécessaire.

[in, optional] ahkeys

Type : HKEY[]

Tableau de clés de Registre qui représentent les CLSIDdes feuilles de propriétés individuelles.

ckeys

Type : UINT

Valeur UINT qui spécifie le nombre de feuilles de propriétés dans le tableau spécifié par ahkeys.

[in, optional] pclsidDefault

Type : const CLSID*

Pointeur vers le CLSID par défaut. Cette valeur peut être NULL.

[in] pdtobj

Type : IDataObject*

Pointeur vers un objet IDataObject, objet OLE qui peut être utilisé pour effectuer des actions sur la ou les feuilles de propriétés.

[in, optional] psb

Type : IShellBrowser*

Non utilisé.

[in, optional] pStartPage

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie la page de démarrage. Cette valeur peut être NULL.

Valeur retournée

Type : BOOL

Retourne TRUE si la feuille de propriétés a été créée avec succès ; sinon, FALSE.

Remarques

Notes

L’en-tête shlobj.h définit SHOpenPropSheet en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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

Partager via