ISpecifyPropertyPages::GetPages-Methode (ocidl.h)
Ruft eine Liste von Eigenschaftenseiten ab, die im Eigenschaftenblatt dieses Objekts angezeigt werden können.
Syntax
HRESULT GetPages(
[out] CAUUID *pPages
);
Parameter
[out] pPages
Ein Zeiger auf eine vom Aufrufer zugewiesene CAUUID-Struktur , die von der Funktion initialisiert und ausgefüllt wird, bevor sie zurückgegeben wird. Das pElems-Element in der Struktur wird von der Funktion mit CoTaskMemAlloc zugeordnet und sollte vom Aufrufer mit CoTaskMemFree freigegeben werden.
Rückgabewert
Diese Methode kann die Standardrückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Die Adresse in pPages ist ungültig. Es kann z. B. NULL sein. |
Hinweise
Die CAUUID-Struktur wird vom Aufrufer zugeordnet, aber nicht vom Aufrufer initialisiert. Die GetPages-Methode füllt das cElements-Element in der Struktur aus. Diese Methode weist auch Arbeitsspeicher für das Array zu, auf das das pElems-Element mithilfe von CoTaskMemAlloc verweist. Anschließend füllt es das neu zugeordnete Array aus. Nachdem diese Methode erfolgreich zurückgegeben wurde, enthält die Struktur ein gezähltes Array von UUIDs, wobei jede UUID eine Eigenschaftenseite CLSID angibt.
Hinweise für Anrufer
Der Aufrufer muss den Speicher freigeben, auf den der pElems-Member von CAUUID verweist, wobei CoTaskMemFree verwendet wird, wenn er nicht mehr benötigt wird.Hinweise zu Implementierern
E_NOTIMPL ist nicht als Rückgabewert zulässig, da ein Objekt ohne Eigenschaftenseiten die ISpecifyPropertyPages-Schnittstelle nicht verfügbar machen sollte.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ocidl.h |