Metodo IAccClientDocMgr::GetFocused (msaatext.h)

I client chiamano il metodo IAccClientDocMgr::GetFocused per accedere a un puntatore per il documento con stato attivo.

Sintassi

HRESULT GetFocused(
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

Parametri

[in] riid

Tipo: REFIID

ID id del documento richiesto. Questo è in genere IID_ITextStoreAnchor.

[out] ppunk

Tipo: IUnknown*

Puntatore di interfaccia al documento richiesto.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Commenti

Se la finestra con stato attivo non è un documento che implementa l'interfaccia ITextStoreACP , ppunk sarà NULL.

I server potrebbero dover eseguire il polling di questo metodo più volte prima di ricevere un documento. Può verificarsi un intervallo di tempo limitato (circa secondo) tra quando viene visualizzato un documento nel sistema e quando viene registrato con i servizi documenti.

Requisiti