Fonction PSRegisterPropertySchema (propsys.h)
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 |
---|---|
|
Toutes les descriptions de propriétés dans le schéma ont été inscrites. |
|
Le contexte appelant ne dispose pas des privilèges appropriés. |
|
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.
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 |