IAccClientDocMgr::LookupByHWND-Methode (msaatext.h)
Clients rufen IAccClientDocMgr::LookupByHWND auf, um ein Dokument abzurufen, indem sie die HWND für das Dokument bereitstellen.
Syntax
HRESULT LookupByHWND(
[in] HWND hWnd,
[in] REFIID riid,
[out] IUnknown **ppunk
);
Parameter
[in] hWnd
Typ: HWND
Der HWND des zurückzugebenden Dokuments.
[in] riid
Typ: REFIID
IID des angeforderten Dokuments. Dies wird in der Regel IID_ITextStoreAnchor.
[out] ppunk
Typ: IUnknown*
Schnittstellenzeiger auf das angeforderte Dokument.
Rückgabewert
Typ: HRESULT
Gibt bei Erfolg S_OK zurück.
Wenn dies nicht erfolgreich ist, wird der folgende Wert oder ein anderer COM-Standardfehlercode zurückgegeben.
Fehler | BESCHREIBUNG |
---|---|
|
Wenn der HWND nicht einem aktiven Dokument entspricht, ist ppunkNULL. |
Hinweise
Server müssen diese Methode möglicherweise mehrmals abfragen, bevor sie ein Dokument erhalten. Zwischen dem Erscheinen eines Dokuments im System und der Registrierung bei Dokumentdiensten kann es zu einem begrenzten Zeitraffer (ca. einer Sekunde) kommen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | msaatext.h |
DLL | Msaatext.dll |
Verteilbare Komponente | Active Accessibility 2.0 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 98 |