Partager via

Méthode IPropertySystem ::RegisterPropertySchema (propsys.h)

  • Article

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

Syntaxe

HRESULT RegisterPropertySchema(
  [in] LPCWSTR pszPath
);

Paramètres

[in] pszPath

Type : LPCWSTR

Pointeur vers le chemin du fichier .propdesc sur l’ordinateur local.

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
 Indique que le schéma est inscrit.
E_ACCESSDENIED
 Indique que le contexte appelant ne dispose pas des privilèges appropriés.
INPLACE_S_TRUNCATED
 Indique qu’une ou plusieurs des descriptions de propriétés dans le schéma n’ont pas été inscrites.

Remarques

Cette méthode informe le sous-système de schéma de l’ajout d’un fichier de schéma de description de propriété (.propdesc), à l’aide d’un chemin d’accès au fichier .propdesc sur l’ordinateur local. Appelez cette méthode uniquement lorsque le fichier a été installé pour la première fois sur l’ordinateur. En règle générale, une application d’installation appelle cette méthode 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 par lots plusieurs fichiers de schéma.

Si un échec est rencontré 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 méthode échoue avec E_ACCESSDENIED si le contexte appelant ne dispose pas des privilèges appropriés, qui incluent l’accès en écriture à HKLM (HKEY_LOCAL_MACHINE). Il incombe à l’application appelante d’obtenir des privilèges via des mécanismes de compte d’utilisateur limité (LUA).

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
DLL Propsys.dll (version 5.0 ou ultérieure)
Composant redistribuable Windows Desktop Search (WDS) 3.0

Voir aussi

IPropertySystem