Fonction PSRegisterPropertySchema (propsys.h)

Article
03/04/2024

Informe le sous-système de schéma de l’ajout d’un fichier de schéma de description de propriété.

Syntaxe

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

Paramètres

[in] pszPath

Type : PCWSTR

Pointeur vers le chemin du fichier complet, sous forme de chaîne Unicode, vers le fichier de schéma de description de propriété (.propdesc) sur l’ordinateur local. Il peut s’agir d’un chemin d’accès complet entièrement spécifié ou d’un chemin d’accès complet qui inclut des variables d’environnement telles que %PROGRAMFILES%.

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Toutes les descriptions de propriétés dans le schéma ont été inscrites.
E_ACCESSDENIED	Le contexte appelant ne dispose pas des privilèges appropriés.
INPLACE_S_TRUNCATED	Une ou plusieurs descriptions de propriétés dans le schéma n’ont pas pu s’inscrire. Les échecs spécifiques sont enregistrés dans le journal des événements de l’application.

Remarques

Cette fonction est une API wrapper pour l’implémentation par le sous-système de schéma de IPropertySystem ::RegisterPropertySchema. Appelez cette fonction uniquement lorsque le fichier est installé pour la première fois sur l’ordinateur. En règle générale, une application d’installation appelle cette fonction après avoir installé le fichier .propdesc, qui doit être stocké dans le répertoire d’installation de l’application sous Program Files. Plusieurs appels peuvent être effectués à IPropertySystem ::RegisterPropertySchema afin d’inscrire plusieurs fichiers de schéma.

Lors de l’inscription de fichiers de schéma de propriétés, n’oubliez pas qu’ils peuvent être lus par des processus s’exécutant en tant qu’utilisateurs différents. Par conséquent, il est important de placer un fichier de schéma à un emplacement qui accorde l’accès en lecture à tous les utilisateurs de l’ordinateur. De même, utilisez le chemin absolu du fichier dans le paramètre pszPath de cette fonction.

Note Étant donné que les schémas sont spécifiques à l’ordinateur et ne peuvent pas être inscrits pour chaque utilisateur individuel, l’inscription d’un chemin d’accès de fichier sous les profils utilisateur n’est pas prise en charge sur Windows Vista.

Si une défaillance totale ou partielle est rencontrée qui empêche le chargement d’une description de propriété, la cause est enregistrée dans le journal des événements de l’application. Cette fonction échoue avec E_ACCESSDENIED si le contexte appelant ne dispose pas des privilèges appropriés, ce qui inclut l’accès en écriture à HKEY_LOCAL_MACHINE. Il incombe à l’application appelante d’obtenir des privilèges via les mécanismes de contrôle de compte d’utilisateur (UAC).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propsys.h
Bibliothèque	Propsys.lib
DLL	Propsys.dll (version 5.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Share via