IPropertySystem::UnregisterPropertySchema method

Informs the schema subsystem of the removal of a property description schema (.propdesc) file, using a file path to the .propdesc file on the local machine.

Syntax


HRESULT UnregisterPropertySchema(
  [in]  LPCWSTR pszPath
);

Parameters

pszPath [in]

Type: LPCWSTR

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

Return value

Type: HRESULT

Returns one of the following values.

Return codeDescription
S_OK

Indicates schema is unregistered.

E_ACCESSDENIED

Indicates calling context does not have proper privileges.

 

Remarks

Call this method when the file is being uninstalled from the machine. Typically, a setup application calls this method before or after uninstalling the .propdesc file. This method can be called after the file no longer exists.

Call IPropertySystem::RefreshPropertySchema in order for the newly-unregistered schema files to be unincorporated from the search index and the schema subsystem cache.

This method fails with E_ACCESSDENIED if the calling context does not have proper privileges, which include write access to the local machine. It is the caller's responsibility to obtain privileges via least-privileged user account (LUA) mechanisms.

Requirements

Minimum supported client

Windows XP with SP2, Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 with SP1 [desktop apps only]

Redistributable

Windows Desktop Search (WDS) 3.0

Header

Propsys.h

IDL

Propsys.idl

DLL

Propsys.dll (version 5.0 or later)

See also

IPropertySystem

 

 

Community Additions

ADD
Show:
© 2014 Microsoft