IFileDialog::GetFileName-Methode (shobjidl_core.h)

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