PSRegisterPropertySchema-Funktion (propsys.h)

Artikel
03/04/2024

Informiert das Schemasubsystem über das Hinzufügen einer Eigenschaftenbeschreibungsschemadatei.

Syntax

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

Parameter

[in] pszPath

Typ: PCWSTR

Zeiger auf den vollständigen Dateipfad als Unicode-Zeichenfolge auf die Eigenschaftsbeschreibungsschemadatei (.propdesc) auf dem lokalen Computer. Dies kann entweder ein vollständig angegebener vollständiger Pfad oder ein vollständiger Pfad sein, der Umgebungsvariablen wie %PROGRAMFILES%enthält.

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Alle Eigenschaftenbeschreibungen im Schema wurden registriert.
E_ACCESSDENIED	Der aufrufende Kontext verfügt nicht über die richtigen Berechtigungen.
INPLACE_S_TRUNCATED	Mindestens eine Eigenschaftsbeschreibung im Schema konnte nicht registriert werden. Die spezifischen Fehler werden im Anwendungsereignisprotokoll protokolliert.

Hinweise

Diese Funktion ist eine Wrapper-API für die Implementierung von IPropertySystem::RegisterPropertySchema im Schemasubsystem. Rufen Sie diese Funktion nur auf, wenn die Datei zum ersten Mal auf dem Computer installiert wird. In der Regel ruft eine Setupanwendung diese Funktion auf, nachdem sie die PROPDESC-Datei installiert hat, die im Installationsverzeichnis der Anwendung unter Programme gespeichert werden sollte. Mehrere Aufrufe von IPropertySystem::RegisterPropertySchema können ausgeführt werden, um mehrere Schemadateien zu registrieren.

Denken Sie beim Registrieren von Eigenschaftenschemadateien daran, dass sie von Prozessen gelesen werden können, die als unterschiedliche Benutzer ausgeführt werden. Daher ist es wichtig, eine Schemadatei an einem Speicherort zu platzieren, der allen Benutzern auf dem Computer Lesezugriff gewährt. Verwenden Sie auf ähnliche Weise den absoluten Pfad zur Datei im pszPath-Parameter dieser Funktion.

Hinweis Da Schemas computerspezifisch sind und nicht für jeden einzelnen Benutzer registriert werden können, wird das Registrieren eines Dateipfads unter Benutzerprofilen unter Windows Vista nicht unterstützt.

Wenn ein vollständiger oder teilweiser Fehler auftritt, der verhindert, dass eine Eigenschaftenbeschreibung geladen wird, wird die Ursache im Anwendungsereignisprotokoll aufgezeichnet. Diese Funktion schlägt mit E_ACCESSDENIED fehl, wenn der aufrufende Kontext nicht über die richtigen Berechtigungen verfügt, einschließlich Schreibzugriff auf HKEY_LOCAL_MACHINE. Es liegt in der Verantwortung der aufrufenden Anwendung, Berechtigungen über Benutzerkontensteuerungsmechanismen (UAC) zu erhalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propsys.h
Bibliothek	Propsys.lib
DLL	Propsys.dll (Version 5.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Share via