IOleCommandTarget::QueryStatus-Methode (docobj.h)
Fragt das Objekt nach dem Status eines oder mehrerer Befehle ab, die von Benutzeroberflächenereignissen generiert wurden.
Syntax
HRESULT QueryStatus(
[in] const GUID *pguidCmdGroup,
[in] ULONG cCmds,
[in, out] OLECMD [] prgCmds,
[in, out] OLECMDTEXT *pCmdText
);
Parameter
[in] pguidCmdGroup
Der eindeutige Bezeichner der Befehlsgruppe; kann NULL sein, um die Standardgruppe anzugeben. Alle Befehle, die im prgCmds-Array übergeben werden, müssen zu der von pguidCmdGroup angegebenen Gruppe gehören.
[in] cCmds
Die Anzahl der Befehle im PrgCmds-Array .
[in, out] prgCmds
Ein vom Aufrufer zugewiesenes Array von OLECMD-Strukturen, das die Befehle angibt, für die der Aufrufer status Informationen benötigt. Diese Methode füllt das cmdf-Element jeder Struktur mit Werten aus der OLECMDF-Enumeration .
[in, out] pCmdText
Ein Zeiger auf eine OLECMDTEXT-Struktur, in der name und/oder status Informationen eines einzelnen Befehls zurückgegeben werden sollen. Dieser Parameter kann NULL sein, um anzugeben, dass der Aufrufer diese Informationen nicht benötigt.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:
| Rückgabecode | Beschreibung |
|---|---|
|
Fehler beim Vorgang. |
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Das prgCmds-Argument ist NULL. |
|
Der pguidCmdGroup-Parameter ist nicht NULL , gibt aber keine erkannte Befehlsgruppe an. |
Hinweise
Aufrufer verwenden QueryStatus , um zu bestimmen, welche Befehle von einem Zielobjekt unterstützt werden. Der Aufrufer kann dann nicht verfügbare Befehle deaktivieren, die andernfalls an das Objekt weitergeleitet würden. Der Aufrufer kann diese Methode auch verwenden, um den Namen oder status eines einzelnen Befehls abzurufen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | docobj.h |