PSRegisterPropertySchema 関数 (propsys.h)

プロパティ記述スキーマ ファイルの追加をスキーマ サブシステムに通知します。

構文

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

パラメーター

[in] pszPath

種類: PCWSTR

Unicode 文字列として、ローカル コンピューター上の プロパティ記述スキーマ (.propdesc) ファイルへの完全なファイル パスへのポインター。 これは、完全に指定された完全なパス、または などの %PROGRAMFILES%環境変数を含む完全なパスのいずれかです。

戻り値

型: HRESULT

次のいずれかの値を返します。

リターン コード	説明
S_OK	スキーマ内のすべてのプロパティの説明が登録されました。
E_ACCESSDENIED	呼び出し元のコンテキストに適切な特権がありません。
INPLACE_S_TRUNCATED	スキーマ内の 1 つ以上のプロパティの説明を登録できませんでした。 特定のエラーは、アプリケーション イベント ログに記録されます。

注釈

この関数は、スキーマ サブシステムが IPropertySystem::RegisterPropertySchema を実装するためのラッパー API です。 ファイルがコンピューターに最初にインストールされている場合にのみ、この関数を呼び出します。 通常、セットアップ アプリケーションは、.propdesc ファイルをインストールした後にこの関数を呼び出します。このファイルは、アプリケーションのインストール ディレクトリの [プログラム ファイル] に格納する必要があります。 複数のスキーマ ファイルを登録するために 、IPropertySystem::RegisterPropertySchema に対して複数の呼び出しを行うことができます。

プロパティ スキーマ ファイルを登録するときは、異なるユーザーとして実行されているプロセスで読み取ることができることに注意してください。 そのため、マシン上のすべてのユーザーに読み取りアクセスを許可する場所にスキーマ ファイルを配置することが重要です。 同様に、この関数の pszPath パラメーターでファイルへの絶対パスを使用します。

プロパティの説明の読み込みを妨げる完全または部分的なエラーが発生した場合、原因はアプリケーション イベント ログに記録されます。 呼び出し元のコンテキストに適切な特権 (HKEY_LOCAL_MACHINEへの書き込みアクセスを含む) がない場合、この関数は E_ACCESSDENIED で失敗します。 呼び出し元のアプリケーションは、ユーザー アカウント制御 (UAC) メカニズムを使用して特権を取得する必要があります。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	propsys.h
Library	Propsys.lib
[DLL]	Propsys.dll (バージョン 5.0 以降)
再頒布可能パッケージ	Windows デスクトップ検索 (WDS) 3.0