IPrintCoreHelper::CreateInstanceOfMSXMLObject メソッド (prcomoem.h)
IPrintCoreHelper::CreateInstanceOfMSXMLObject メソッドは、正しい MSXML DLL を使用して MSXML 6.0 オブジェクトのインスタンスを作成します。
構文
HRESULT CreateInstanceOfMSXMLObject(
[in] IN REFCLSID rclsid,
[in] IN LPUNKNOWN pUnkOuter,
[in] IN DWORD dwClsContext,
[in] IN REFIID riid,
[out] OUT LPVOID *ppv
);
パラメーター
[in] rclsid
オブジェクトの作成に使用されるデータとコードに関連付けられている CLSID。
[in] pUnkOuter
集計オブジェクトの IUnknown インターフェイス (制御する IUnknown) へのポインター。 このパラメーターは NULL である必要があります。これは、オブジェクトが集計の一部として作成されていないことを意味します。
[in] dwClsContext
新しく作成されたオブジェクトを管理するコードが実行されるコンテキスト。 有効な値は NULL とCLSCTX_INPROC_SERVERのみです。これは CLSCTX 列挙の値です (Microsoft Windows SDKドキュメントで説明されています)。
[in] riid
オブジェクトとの通信に使用されるインターフェイスの識別子への参照。
[out] ppv
riid パラメーターで要求されたインターフェイスのアドレスを受け取る変数へのポインター。 IPrintCoreHelper::CreateInstanceOfMSXMLObject が正常に戻った場合、*ppv には要求されたインターフェイスのアドレスが含まれます。 このメソッドが失敗した場合、*ppv には NULL が含まれます。
戻り値
IPrintCoreHelper::CreateInstanceOfMSXMLObject は、次のいずれかの値を返す必要があります。
リターン コード | 説明 |
---|---|
|
指定したオブジェクト クラスのインスタンスが正常に作成されました。 |
|
指定したクラスを集計の一部として作成することはできません。 |
|
指定したクラスは、要求されたインターフェイスを実装しないか、制御する IUnknown インターフェイスが要求されたインターフェイスを公開しません。 |
|
指定したクラスが登録データベースに登録されていません。 この値は、CLSCTX 列挙型で要求したサーバーの種類が登録されていないか、レジストリ内のサーバーの種類の値が破損していることを示すこともできます。 |
注釈
IPrintCoreHelper::CreateInstanceOfMSXMLObject を使用すると、ダウンレベルのクライアント マシン (Windows Server 2003、Windows XP、または Windows 2000 を実行するクライアント マシン) で実行されている場合でも、プラグインで MSXML オブジェクトを安全に使用できます。
このメソッドのパラメーターは、 CoCreateInstance 関数のパラメーターに直接マップされます (Windows SDK ドキュメントで説明されています)。 以前のバージョンの Windows を実行しているコンピューターに Windows Vista ドライバーをインストールしても、MSXML 6.0 はインストールされないことに注意してください。 実際の DLL はドライバーに依存する DLL に含まれており、ドライバー ディレクトリから読み込まれます。 システムに登録されていません。 このメソッドを使用するプラグインでは、MSXML オブジェクトのみを作成する必要があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | prcomoem.h (Prcomoem.h を含む) |