Fonction SHObjectProperties (shlobj_core.h)

Article
03/02/2024

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

Appelle la commande de menu contextuel Propriétés sur un objet Shell.

Syntaxe

BOOL SHObjectProperties(
  [in] HWND   hwnd,
  [in] DWORD  shopObjectType,
  [in] PCWSTR pszObjectName,
  [in] PCWSTR pszPropertyPage
);

Paramètres

[in] hwnd

Type : HWND

Handle de la fenêtre parente de la boîte de dialogue. Cette valeur peut être NULL.

[in] shopObjectType

Type : DWORD

Valeur d’indicateur qui spécifie le type d’objet.

SHOP_PRINTERNAME

pszObjectName contient le nom convivial d’une imprimante.

SHOP_FILEPATH

pszObjectName contient un nom de fichier complet.

SHOP_VOLUMEGUID

pszObjectName contient (a) un nom de volume de la forme \ ?\Volume{GUID}, où {GUID} est un identificateur global unique (par exemple, « \ ?\Volume{2eca078d-5cbc-43d3-aff8-7e8511f60d0e}) », ou (b) un chemin d’accès de lecteur (par exemple, « C : »).

[in] pszObjectName

Type : PCWSTR

Chaîne Unicode terminée par null qui contient le nom de l’objet. Le contenu de la chaîne est déterminé par l’ensemble d’indicateurs dans shopObjectType.

[in] pszPropertyPage

Type : PCWSTR

Chaîne Unicode terminée par null qui contient le nom de la page de feuille de propriétés à ouvrir initialement. Définissez ce paramètre sur NULL pour spécifier la page par défaut.

Valeur retournée

Type : BOOL

TRUE si la commande est appelée avec succès ; sinon, FALSE.

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_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via