Funzione PSRegisterPropertySchema (propsys.h)

Articolo
08/25/2023

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

Condividi tramite