Freigeben über

IPropertySystem::RegisterPropertySchema-Methode (propsys.h)

  • Artikel

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

Syntax

HRESULT RegisterPropertySchema(
  [in] LPCWSTR pszPath
);

Parameter

[in] pszPath

Typ: LPCWSTR

Zeiger auf den Dateipfad für die PROPDESC-Datei auf dem lokalen Computer.

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Gibt an, dass das Schema registriert ist.
E_ACCESSDENIED
 Gibt an, dass der aufrufende Kontext nicht über die richtigen Berechtigungen verfügt.
INPLACE_S_TRUNCATED
 Gibt an, dass mindestens eine der Eigenschaftenbeschreibungen im Schema nicht registriert wurde.

Hinweise

Diese Methode informiert das Schemasubsystem über das Hinzufügen einer Eigenschaftsbeschreibungsschemadatei (.propdesc) mithilfe eines Dateipfads zur PROPDESC-Datei auf dem lokalen Computer. Rufen Sie diese Methode nur auf, wenn die Datei zum ersten Mal auf dem Computer installiert wurde. In der Regel ruft eine Setupanwendung diese Methode nach der Installation der PROPDESC-Datei auf, die im Installationsverzeichnis der Anwendung unter "Programme" gespeichert werden sollte. Es können mehrere Aufrufe von IPropertySystem::RegisterPropertySchema ausgeführt werden, um mehrere Schemadateien im Batch zu registrieren.

Wenn ein Fehler auftritt, der verhindert, dass eine Eigenschaftenbeschreibung geladen wird, wird die Ursache im Anwendungsereignisprotokoll aufgezeichnet. Diese Methode schlägt mit E_ACCESSDENIED fehl, wenn der aufrufende Kontext nicht über die richtigen Berechtigungen verfügt, einschließlich Schreibzugriff auf HKLM (HKEY_LOCAL_MACHINE). Es liegt in der Verantwortung der aufrufenden Anwendung, Berechtigungen über LUA-Mechanismen (Limited User Account) 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
DLL Propsys.dll (Version 5.0 oder höher)
Verteilbare Komponente Windows Desktop Search (WDS) 3.0

Weitere Informationen

IPropertySystem