IFileDialog::Advise-Methode (shobjidl_core.h)

  • Artikel

Weist einen Ereignishandler zu, der auf Ereignisse aus dem Dialogfeld lauscht.

Syntax

HRESULT Advise(
  [in]  IFileDialogEvents *pfde,
  [out] DWORD             *pdwCookie
);

Parameter

[in] pfde

Typ: IFileDialogEvents*

Ein Zeiger auf eine IFileDialogEvents-Implementierung , die Ereignisse aus dem Dialogfeld empfängt.

[out] pdwCookie

Typ: DWORD*

Ein Zeiger auf ein DWORD , das einen Wert empfängt, der diesen Ereignishandler identifiziert. Wenn der Client mit dem Dialogfeld fertig ist, muss dieser Client die IFileDialog::Unadvise-Methode mit diesem Wert aufrufen.

Rückgabewert

Typ: HRESULT

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

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)