ISpecifyPropertyPages::GetPages メソッド (ocidl.h)
このオブジェクトのプロパティ シートに表示できるプロパティ ページの一覧を取得します。
構文
HRESULT GetPages(
[out] CAUUID *pPages
);
パラメーター
[out] pPages
呼び出し元によって割り当てられた CAUUID 構造体へのポインター。関数は、関数がを返す前に初期化して入力します。 構造体の pElems メンバーは 、CoTaskMemAlloc を使用して関数によって割り当てられ、 CoTaskMemFree を使用して呼び出し元によって解放される必要があります。
戻り値
このメソッドは、E_OUTOFMEMORYおよびE_UNEXPECTED標準の戻り値と、次の値を返すことができます。
リターン コード | 説明 |
---|---|
|
メソッドは正常に完了しました。 |
|
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 |