IPersist::GetClassID メソッド (objidl.h)

[アーティクル]
03/05/2024

オブジェクトのクラス識別子 (CLSID) を取得します。

構文

HRESULT GetClassID(
  [out] CLSID *pClassID
);

パラメーター

[out] pClassID

戻り時に CLSID を受け取る場所へのポインター。 CLSID は、オブジェクトのデータを操作できるコードを定義するオブジェクトクラスを一意に表すグローバル一意識別子 (GUID) です。

戻り値

メソッドが成功した場合、戻り値はS_OK。それ以外の場合は、E_FAIL。

注釈

GetClassID メソッドは、オブジェクトのクラス識別子 (CLSID) を取得します。これは、オブジェクト固有のコードを呼び出し元のコンテキストに読み込むための後の操作で使用されます。

呼び出し元へのメモ

コンテナーアプリケーションでは、このメソッドを呼び出して、別のクラスとして扱うオブジェクトの元の CLSID を取得できます。このような呼び出しは、ユーザーがオブジェクトの保存を必要とする編集操作を実行した場合に必要になります。コンテナーが CLSID として扱いを使用して保存する場合、元のアプリケーションはオブジェクトを編集できなくなります。通常、この場合、コンテナーは OleSave ヘルパー関数を呼び出し、必要なすべての手順を実行します。このため、ほとんどのコンテナーアプリケーションでは、このメソッドを直接呼び出す必要はありません。

例外は、特定のオブジェクトのオブジェクトハンドラーを提供するコンテナーです。特に、コンテナーアプリケーションはオブジェクトの CLSID を取得し、それを使用してレジストリからクラス固有の情報を取得しないでください。代わりに、コンテナーは IOleObject インターフェイスと IDataObject インターフェイスを使用して、このようなクラス固有の情報をオブジェクトから直接取得する必要があります。

実装者へのメモ

通常、このメソッドの実装では、オブジェクトに定数 CLSID を指定するだけです。ただし、オブジェクトの TreatAs レジストリキーがエミュレーションをサポートするアプリケーションによって設定されている場合 (オブジェクトを別のクラスの 1 つとして扱う場合)、 GetClassID の呼び出しで TreatAs キーで指定された CLSID を指定する必要があります。エミュレーションの詳細については、「 CoTreatAsClass」を参照してください。

オブジェクトが実行中の状態の場合、既定のハンドラーは GetClassID の実装を呼び出し、その呼び出しをオブジェクトの実装に委任します。オブジェクトが実行されていない場合、既定のハンドラーは代わりに ReadClassStg 関数を呼び出して、オブジェクトのストレージに保存されている CLSID を読み取ります。

オブジェクトのカスタムオブジェクトハンドラーを作成する場合は、このメソッドを既定のハンドラー実装に単に委任できます ( 「OleCreateDefaultHandler」を参照)。

URL モニカーに関するメモ

このメソッドは、CLSID_StdURLMonikerを返します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	objidl.h