Méthode ITfSource::AdviseSink (msctf.h)

Article
08/24/2023

Installe un récepteur de conseil.

Syntaxe

HRESULT AdviseSink(
  [in]  REFIID   riid,
  [in]  IUnknown *punk,
  [out] DWORD    *pdwCookie
);

Paramètres

[in] riid

Identifie le type de récepteur conseillé à installer.

Ce paramètre peut être l’une des valeurs suivantes lorsque l’objet ITfSource est obtenu à partir d’un objet ITfThreadMgr .

Ce paramètre peut être l’une des valeurs suivantes lorsque l’objet ITfSource est obtenu à partir d’un objet ITfContext .

Valeur	Signification
IID_ITfActiveLanguageProfileNotifySink	Installe un récepteur de conseil ITfActiveLanguageProfileNotifySink .
IID_ITfDisplayAttributeNotifySink	Installe un récepteur de conseil ITfDisplayAttributeNotifySink .
IID_ITfKeyTraceEventSink	Installe un récepteur de conseil ITfKeyTraceEventSink .
IID_ITfPreservedKeyNotifySink	Installe un récepteur de conseil ITfPreservedKeyNotifySink .
IID_ITfThreadFocusSink	Installe un récepteur de conseil ITfThreadFocusSink .
IID_ITfThreadMgrEventSink	Installe un récepteur de conseil ITfThreadMgrEventSink .

[in] punk

Pointeur IUnknown du récepteur conseillé.

[out] pdwCookie

Adresse d’une valeur DWORD qui reçoit un cookie d’identification. Cette valeur est utilisée pour désinstaller le récepteur de conseil dans un appel ultérieur à ITfSource::UnadviseSink. Reçoit (DWORD)-1 en cas de défaillance.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
CONNECT_E_CANNOTCONNECT	Impossible d’installer le récepteur conseillé.
CONNECT_E_ADVISELIMIT	Le nombre maximal de récepteurs conseillés a été atteint.
E_FAIL	Une erreur non spécifiée s'est produite.
E_OUTOFMEMORY	Un échec d’allocation de mémoire s’est produit.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel