Método IOleObject::GetMiscStatus (oleidl.h)

Artigo
03/05/2024

Recupera o status de um objeto na criação e no carregamento.

Sintaxe

HRESULT GetMiscStatus(
  [in]  DWORD dwAspect,
  [out] DWORD *pdwStatus
);

Parâmetros

[in] dwAspect

O aspecto de um objeto sobre o qual status informações está sendo solicitada. O valor é obtido da enumeração DVASPECT.

[out] pdwStatus

Ponteiro para onde as informações de status são retornadas. Esse parâmetro não pode ser NULL.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
OLE_S_USEREG	Delegue a recuperação de diversas informações de status para a implementação desse método pelo manipulador padrão.
CO_E_CLASSNOTREG	Não há CLSID registrado para o objeto .
CO_E_READREGDB	Erro ao acessar o registro.

Comentários

Um contêiner normalmente chama IOleObject::GetMiscStatus quando cria ou carrega um objeto para determinar como exibir o objeto e quais tipos de comportamentos ele dá suporte.

Os objetos armazenam informações de status no registro. Se o objeto não estiver em execução, a implementação do manipulador padrão de IOleObject::GetMiscStatus recuperará essas informações do registro. Se o objeto estiver em execução, o manipulador padrão invocará IOleObject::GetMiscStatus no próprio objeto.

As informações que são realmente armazenadas no registro variam de acordo com objetos individuais. Os valores status a serem retornados são definidos na enumeração OLEMISC.

O valor padrão de IOleObject::GetMiscStatus será usado se uma subchave correspondente ao DVASPECT especificado não for encontrada. Para definir um controle OLE, especifique DVASPECT==1. Isso fará com que o seguinte ocorra no registro:

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

Observações aos implementadores

A implementação normalmente consiste em delegar a chamada ao manipulador padrão.

Requisitos

Requisito	Valor
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	oleidl.h