IFileDialog::GetFileName-Methode (shobjidl_core.h)

  • Artikel

Ruft den Text ab, der derzeit im Bearbeitungsfeld Dateiname des Dialogfelds eingegeben wurde.

Syntax

HRESULT GetFileName(
  [out] LPWSTR *pszName
);

Parameter

[out] pszName

Typ: WCHAR**

Die Adresse eines Zeigers auf einen Puffer, der den Text empfängt, wenn diese Methode erfolgreich zurückgibt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Der Text im Bearbeitungsfeld Dateiname spiegelt nicht unbedingt das element wider, das der Benutzer ausgewählt hat. Verwenden Sie IFileDialog::GetResult, um das vom Benutzer ausgewählte Element abzurufen.

Die aufrufende Anwendung ist dafür verantwortlich, den abgerufenen Puffer mithilfe der CoTaskMemFree-Funktion freizugeben.

Anforderungen

Anforderung Wert
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)