SHOpenPropSheetA, fonction (shlobj.h)

Article
11/20/2024

[SHOpenPropSheet est disponible pour une utilisation 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 qui contiennent les CLSIDs des 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 la 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 CLSIDs des 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 laCLSID par défaut . Cette valeur peut être NULL.

[in] pdtobj

Type : * IDataObject

Pointeur vers un 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 de retour

Type : BOOL

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

Remarques

Note

L’en-tête shlobj.h définit SHOpenPropSheet comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlobj.h
bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via