共用方式為

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 釋放 CAUUID 的 pElems 成員所指向的記憶體。

實作者的注意事項

E_NOTIMPL不允許做為傳回值，因為沒有屬性頁的對象不應該公開 ISpecifyPropertyPages 介面。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

ISpecifyPropertyPages