IFileOpenDialog::GetSelectedItems-Methode (shobjidl_core.h)

Ruft die derzeit ausgewählten Elemente im Dialogfeld ab. Bei diesen Elementen kann es sich um elemente handeln, die in der Ansicht ausgewählt sind, oder um Text, der im Bearbeitungsfeld für den Dateinamen ausgewählt ist.

Syntax

HRESULT GetSelectedItems(
  [out] IShellItemArray **ppsai
);

Parameter

[out] ppsai

Typ: IShellItemArray**

Die Adresse eines Zeigers auf ein IShellItemArray,über das auf die ausgewählten Elemente zugegriffen werden kann.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode kann für die Auswahl einzelner elemente oder mehrerer Elemente verwendet werden. Wenn der Benutzer im Feld "Dateiname" einen neuen Text eingegeben hat, kann dies zeitaufwendig sein. Wenn die Anwendung diese Methode aufruft, analysiert die Anwendung den Text im filename Feld. Wenn es sich beispielsweise um eine Netzwerkfreigabe handelt, kann der Vorgang einige Zeit in Anspruch nehmen. Dieser Vorgang blockiert die Benutzeroberfläche jedoch nicht, da der Benutzer den Vorgang beenden können sollte, was dazu führt, dass IFileOpenDialog::GetSelectedItems einen Fehlercode zurückgibt.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)