ISpecifyPropertyPages::GetPages-Methode (ocidl.h)

  • Artikel

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
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_POINTER
 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

Weitere Informationen

Ispecifypropertypages