Método IOleCommandTarget::QueryStatus (docobj.h)
Consulta o objeto para saber o status de um ou mais comandos gerados pelos eventos da interface do usuário.
Sintaxe
HRESULT QueryStatus(
[in] const GUID *pguidCmdGroup,
[in] ULONG cCmds,
[in, out] OLECMD [] prgCmds,
[in, out] OLECMDTEXT *pCmdText
);
Parâmetros
[in] pguidCmdGroup
O identificador exclusivo do grupo de comandos; pode ser NULL para especificar o grupo padrão. Todos os comandos passados na matriz prgCmds devem pertencer ao grupo especificado por pguidCmdGroup.
[in] cCmds
O número de comandos na matriz prgCmds .
[in, out] prgCmds
Uma matriz alocada pelo chamador de estruturas OLECMD que indicam os comandos para os quais o chamador precisa status informações. Esse método preenche o membro cmdf de cada estrutura com valores obtidos da enumeração OLECMDF .
[in, out] pCmdText
Um ponteiro para uma estrutura OLECMDTEXT na qual retornar o nome e/ou status informações de um único comando. Esse parâmetro pode ser NULL para indicar que o chamador não precisa dessas informações.
Valor retornado
Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
Falha na operação. |
|
Ocorreu um erro inesperado. |
|
O argumento prgCmds é NULL. |
|
O parâmetro pguidCmdGroup não é NULL , mas não especifica um grupo de comandos reconhecido. |
Comentários
Os chamadores usam QueryStatus para determinar quais comandos têm suporte de um objeto de destino. Em seguida, o chamador pode desabilitar comandos indisponíveis que, de outra forma, seriam roteados para o objeto . O chamador também pode usar esse método para obter o nome ou status de um único comando.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | docobj.h |