Funzione PSRegisterPropertySchema (propsys.h)

  • Articolo

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

Sintassi

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

Parametri

[in] pszPath

Tipo: PCWSTR

Puntatore al percorso completo del file, come stringa Unicode, al file dello schema della descrizione della proprietà (con estensione propdesc) nel computer locale. Può trattarsi di un percorso completo specificato completamente o di un percorso completo che include variabili di ambiente, ad %PROGRAMFILES%esempio .

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti.

Codice restituito Descrizione
S_OK
 Tutte le descrizioni delle proprietà nello schema sono state registrate.
E_ACCESSDENIED
 Il contesto chiamante non dispone di privilegi appropriati.
INPLACE_S_TRUNCATED
 Impossibile registrare una o più descrizioni delle proprietà nello schema. Gli errori specifici vengono registrati nel registro eventi dell'applicazione.

Commenti

Questa funzione è un'API wrapper per l'implementazione del sottosistema dello schema di IPropertySystem::RegisterPropertySchema. Chiamare questa funzione solo quando il file viene installato per la prima volta nel computer. In genere, un'applicazione di installazione chiama questa funzione dopo aver installato il file 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.

Quando si registrano i file dello schema delle proprietà, tenere presente che possono essere letti dai processi in esecuzione come utenti diversi. È quindi importante inserire un file di schema in un percorso che concede l'accesso in lettura a tutti gli utenti del computer. Analogamente, usare il percorso assoluto del file nel parametro pszPath di questa funzione.

Nota Poiché gli schemi sono specifici del computer e non possono essere registrati per ogni singolo utente, la registrazione di un percorso di file nei profili utente non è supportata in Windows Vista.
 
Se si verifica un errore completo o parziale che impedisce il caricamento di una descrizione della proprietà, la causa viene registrata nel registro eventi dell'applicazione. Questa funzione ha esito negativo con E_ACCESSDENIED se il contesto chiamante non dispone di privilegi appropriati, che include l'accesso in scrittura a HKEY_LOCAL_MACHINE. È responsabilità dell'applicazione chiamante ottenere privilegi tramite meccanismi di controllo dell'account utente.

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
Libreria Propsys.lib
DLL Propsys.dll (versione 5.0 o successiva)
Componente ridistribuibile Windows Desktop Search (WDS) 3.0