更新 : 2007 年 11 月
実装されている場合、ホストから進行状況とエラーのカスタム メッセージを取得するために PresentationHost.exe によって呼び出されます。
HRESULT GetCustomUI( [out] BSTR* pwzProgressAssemblyName, [out] BSTR* pwzProgressClassName, [out] BSTR* pwzErrorAssemblyName, [out] BSTR* pwzErrorClassName );
パラメータ
pwzProgressAssemblyName
[out] ホストから提供される、進行状況のユーザー インターフェイスを格納するアセンブリへのポインタ。
pwzProgressClassName
[out] ホストから提供される、進行状況のユーザー インターフェイスのクラス名。Page を持つ XAML ファイルは、このクラスのトップ レベルの要素にすることをお勧めします。このクラスは、pwzProgressAssemblyName で指定されたアセンブリにあります。
pwzErrorAssemblyName
[out] ホストから提供される、エラーのユーザー インターフェイスを格納するアセンブリへのポインタ。
pwzErrorClassName
[out] ホストから提供される、エラーのユーザー インターフェイスのクラス名。Page を持つ XAML ファイルは、このクラスのトップ レベルの要素にすることをお勧めします。このクラスは、pwzErrorAssemblyName で指定されたアセンブリにあります。
プロパティ値/戻り値
HRESULT : 無視されます。
解説
ホスト アプリケーションは、PresentationHost.exe の既定のユーザー インターフェイスが準拠できない特定のテーマを持つ場合があります。このような場合は、ホスト アプリケーションに GetCustomUI を実装して、PresentationHost.exe に進行状況とエラーのユーザー インターフェイスを返すことができます。PresentationHost.exe は常に、既定のユーザー インターフェイスを使用する前に GetCustomUI を呼び出します。
この関数は、PresentationHost の初期化中に 1 回呼び出されます。