ISpecifyPropertyPages::GetPages メソッド (ocidl.h)

このオブジェクトのプロパティ シートに表示できるプロパティ ページの一覧を取得します。

構文

HRESULT GetPages(
  [out] CAUUID *pPages
);

パラメーター

[out] pPages

呼び出し元によって割り当てられた CAUUID 構造体へのポインター。関数は、関数がを返す前に初期化して入力します。 構造体の pElems メンバーは 、CoTaskMemAlloc を使用して関数によって割り当てられ、 CoTaskMemFree を使用して呼び出し元によって解放される必要があります。

戻り値

このメソッドは、E_OUTOFMEMORYおよびE_UNEXPECTED標準の戻り値と、次の値を返すことができます。

リターン コード	説明
S_OK	メソッドは正常に完了しました。
E_POINTER	pPages のアドレスが無効です。 たとえば、 NULL にすることができます。

注釈

CAUUID 構造体は呼び出し元によって割り当てられますが、呼び出し元によって初期化されません。 GetPages メソッドは、構造体の cElements メンバーに入力します。 また、このメソッドは、CoTaskMemAlloc を使用して pElems メンバーが指す配列にメモリを割り当てます。 次に、新しく割り当てられた配列を埋めます。 このメソッドが正常に返された後、構造体には UUID のカウントされた配列が含まれます。各 UUID はプロパティ ページ CLSID を指定します。

呼び出し元へのメモ

呼び出し元は、COTaskMemFree が不要になったときに CoTaskMemFree を使用して、CAUUID の pElems メンバーが指すメモリを解放する必要があります。

実装者へのメモ

プロパティ ページを持たないオブジェクトは ISpecifyPropertyPages インターフェイスを公開してはならないため、E_NOTIMPLは戻り値として使用できません。

要件

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

こちらもご覧ください

ISpecifyPropertyPages