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
E_FAIL
Falha na operação.
E_UNEXPECTED
Ocorreu um erro inesperado.
E_POINTER
O argumento prgCmds é NULL.
OLECMDERR_E_UNKNOWNGROUP
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

Confira também

IOleCommandTarget

OLECMD

OLECMDF

OLECMDTEXT