Share via

PSRegisterPropertySchema 函式 (propsys.h)

  • 發行項

通知架構子系統新增屬性描述架構檔案。

語法

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

參數

[in] pszPath

類型： PCWSTR

作為 Unicode 字串的完整檔案路徑指標，指向 本機電腦上的屬性描述架構 (.propdesc) 檔案。 這可以是完整指定的完整路徑，或包含環境變數的完整路徑，例如 %PROGRAMFILES%。

傳回值

類型： HRESULT

傳回下列其中一個值。

傳回碼 描述
S_OK
 架構中的所有屬性描述都已註冊。
E_ACCESSDENIED
 呼叫內容沒有適當的許可權。
INPLACE_S_TRUNCATED
 架構中的一或多個屬性描述無法註冊。 特定失敗會記錄在應用程式事件記錄檔中。

備註

此函式是架構子系統 IPropertySystem：：RegisterPropertySchema 實作的包裝函式 API。 只有在計算機第一次安裝檔案時，才呼叫此函式。 一般而言，安裝程式應用程式會在安裝 .propdesc 檔案之後呼叫此函式，此檔案應該儲存在應用程式安裝目錄中的程序檔底下。 您可以對 IPropertySystem：：RegisterPropertySchema 進行多個呼叫，以註冊多個架構檔案。

註冊屬性架構檔案時，請記住，這些檔案可由以不同使用者身分執行的進程讀取。 因此，請務必將架構檔案放在將讀取許可權授與計算機上所有使用者的位置。 同樣地，請使用這個函式 pszPath 參數中檔案的絕對路徑。

注意 因為架構是計算機特有的，而且無法為每個個別用戶註冊，所以 Windows Vista 不支援在使用者配置檔下註冊檔案路徑。
 
如果遇到導致屬性描述無法載入的完整或部分失敗，則會在應用程式事件記錄檔中記錄原因。 如果呼叫內容沒有適當的許可權，則此函式會因為E_ACCESSDENIED而失敗，其中包括HKEY_LOCAL_MACHINE的寫入許可權。 呼叫應用程式必須負責透過使用者帳戶控制 (UAC) 機制來取得許可權。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 propsys.h
程式庫 Propsys.lib
Dll Propsys.dll (5.0 版或更新版本)
可轉散發套件 Windows 桌面搜尋 (WDS) 3.0