Metodo IPropertySystem::RegisterPropertySchema (propsys.h)

Informa il sottosistema dello schema dell'aggiunta di un file dello schema di descrizione della proprietà.

Sintassi

HRESULT RegisterPropertySchema(
  [in] LPCWSTR pszPath
);

Parametri

[in] pszPath

Tipo: LPCWSTR

Puntatore al percorso del file per il file con estensione propdesc nel computer locale.

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Indica che lo schema è registrato.
E_ACCESSDENIED	Indica che il contesto di chiamata non ha privilegi appropriati.
INPLACE_S_TRUNCATED	Indica una o più descrizioni delle proprietà nello schema non è stata registrata.

Commenti

Questo metodo informa il sottosistema dello schema dell'aggiunta di un file schema di descrizione delle proprietà (con estensione propdesc), usando un percorso file al file con estensione propdesc nel computer locale. Chiamare questo metodo solo quando il file è stato installato per la prima volta nel computer. In genere, un'applicazione di installazione chiama questo metodo dopo aver installato il file con estensione propdesc, che deve essere archiviato nella directory di installazione dell'applicazione in "Programmi". È possibile effettuare più chiamate a IPropertySystem::RegisterPropertySchema per registrare più file di schema.

Se si verifica un errore che impedisce il caricamento di una descrizione della proprietà, la causa verrà registrata nel registro eventi dell'applicazione. Questo metodo non riesce con E_ACCESSDENIED se il contesto chiamante non dispone di privilegi appropriati, che includono l'accesso in scrittura a HKLM (HKEY_LOCAL_MACHINE). È responsabilità dell'applicazione chiamante ottenere privilegi tramite meccanismi LUA (Limited User Account).

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h
DLL	Propsys.dll (versione 5.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Vedi anche

IPropertySystem