Metodo ISimpleFrameSite::P reMessageFilter (ocidl.h)

Articolo
03/05/2024

Fornisce un sito con l'opportunità di elaborare un messaggio ricevuto dalla propria finestra di un controllo prima che il controllo stesso esegue qualsiasi elaborazione.

Sintassi

HRESULT PreMessageFilter(
  [in]  HWND    hWnd,
  [in]  UINT    msg,
  [in]  WPARAM  wp,
  [in]  LPARAM  lp,
  [out] LRESULT *plResult,
  [out] DWORD   *pdwCookie
);

Parametri

[in] hWnd

Handle della finestra di controllo che riceve il messaggio.

[in] msg

Messaggio ricevuto dal sito frame semplice.

[in] wp

WPARAM del messaggio.

[in] lp

LPARAM del messaggio.

[out] plResult

Puntatore alla variabile che riceve il risultato dell'elaborazione del messaggio.

[out] pdwCookie

Puntatore alla variabile che verrà passata a ISimpleFrameSite::P ostMessageFilter se viene chiamata in seguito. Questo parametro deve contenere solo i dati allocati se questo metodo restituisce S_OK in modo da ricevere anche una chiamata a PostMessageFilter che può liberare l'allocazione. Il chiamante non è in alcun modo responsabile di alcun elemento restituito in questo parametro.

Valore restituito

Questo metodo può restituire i valori seguenti.

Codice restituito	Descrizione
S_OK	Il sito di frame semplice non userà il messaggio in questo filtro in modo da poter eseguire più elaborazione.
S_FALSE	Il sito ha elaborato il messaggio e non dovrebbe verificarsi ulteriore elaborazione.
E_NOTIMPL	Il sito non esegue alcun filtro dei messaggi, che indica che PostMessageFilter non deve essere chiamato in seguito.
E_POINTER	L'indirizzo in plResult o pdwCookie non è valido.

Commenti

I valori restituiti con esito positivo indicano se il sito desidera consentire un'ulteriore elaborazione. S_OK indica un'ulteriore elaborazione, mentre S_FALSE significa non elaborare ulteriormente. S_OK indica anche che il controllo deve chiamare in seguito PostMessageFilter.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

ISimpleFrameSite

Condividi tramite