Skip to content

Latest commit

 

History

History
117 lines (97 loc) · 4.24 KB

nf-propsys-ipropertysystem-registerpropertyschema.md

File metadata and controls

117 lines (97 loc) · 4.24 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:propsys.IPropertySystem.RegisterPropertySchema
IPropertySystem::RegisterPropertySchema (propsys.h)
Informs the schema subsystem of the addition of a property description schema file. (IPropertySystem.RegisterPropertySchema)
IPropertySystem interface [Windows Properties]
RegisterPropertySchema method
IPropertySystem.RegisterPropertySchema
IPropertySystem::RegisterPropertySchema
RegisterPropertySchema
RegisterPropertySchema method [Windows Properties]
RegisterPropertySchema method [Windows Properties]
IPropertySystem interface
properties.IPropertySystem_RegisterPropertySchema
propsys/IPropertySystem::RegisterPropertySchema
shell.IPropertySystem_RegisterPropertySchema
shell_IPropertySystem_RegisterPropertySchema
properties\IPropertySystem_RegisterPropertySchema.htm
properties
752cc873-3fa8-4e05-97e7-41e90f059e4f
12/05/2018
IPropertySystem interface [Windows Properties],RegisterPropertySchema method, IPropertySystem.RegisterPropertySchema, IPropertySystem::RegisterPropertySchema, RegisterPropertySchema, RegisterPropertySchema method [Windows Properties], RegisterPropertySchema method [Windows Properties],IPropertySystem interface, properties.IPropertySystem_RegisterPropertySchema, propsys/IPropertySystem::RegisterPropertySchema, shell.IPropertySystem_RegisterPropertySchema, shell_IPropertySystem_RegisterPropertySchema
propsys.h
Windows
Windows XP with SP2, Windows Vista [desktop apps only]
Windows Server 2003 with SP1 [desktop apps only]
Propsys.idl
Propsys.dll (version 5.0 or later)
Windows
Windows Desktop Search (WDS) 3.0
19H1
IPropertySystem::RegisterPropertySchema
propsys/IPropertySystem::RegisterPropertySchema
c++
APIRef
kbSyntax
COM
Propsys.dll
IPropertySystem.RegisterPropertySchema

IPropertySystem::RegisterPropertySchema

-description

Informs the schema subsystem of the addition of a property description schema file.

-parameters

-param pszPath [in]

Type: LPCWSTR

Pointer to the file path for the .propdesc file on the local machine.

-returns

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
Indicates schema is registered.
E_ACCESSDENIED
Indicates calling context does not have proper privileges.
INPLACE_S_TRUNCATED
Indicates one or more of the property descriptions in the schema was not registered.

-remarks

This method informs the schema subsystem of the addition of a property description schema (.propdesc) file, using a file path to the .propdesc file on the local computer. Call this method only when the file has first been installed on the computer. Typically, a setup application calls this method after installing the .propdesc file, which should be stored in the install directory of the application under "Program Files". Multiple calls may be made to IPropertySystem::RegisterPropertySchema in order to batch-register multiple schema files.

If a failure is encountered that prevents a property description from getting loaded, the cause will be recorded in the application event log. This method fails with E_ACCESSDENIED if the calling context does not have proper privileges, which include write access to HKLM (HKEY_LOCAL_MACHINE). It is the responsibility of the calling application to obtain privileges via limited user account (LUA) mechanisms.

-see-also

IPropertySystem