Função OleRegGetMiscStatus (ole2.h)

  • Artigo

Retorna informações diversas sobre a apresentação e os comportamentos compatíveis com o CLSID especificado do registro.

Essa função é usada por desenvolvedores de aplicativos de objeto DLL personalizados para emular o comportamento do manipulador padrão OLE.

Sintaxe

HRESULT OleRegGetMiscStatus(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwAspect,
  [out] DWORD    *pdwStatus
);

Parâmetros

[in] clsid

O CLSID da classe para a qual status informações devem ser solicitadas.

[in] dwAspect

O aspecto da apresentação da classe para a qual as informações são solicitadas. Os valores possíveis são obtidos da enumeração DVASPECT .

[out] pdwStatus

Um ponteiro para a variável que recebe as informações de status.

Valor retornado

Essa função pode retornar o valor de retorno padrão E_OUTOFMEMORY, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 As informações de status foram retornadas com êxito.
REGDB_E_CLASSNOTREG
 Nenhum CLSID está registrado para o objeto de classe.
REGDB_E_READREGDB
 Houve um erro ao ler do registro.
OLE_E_REGDB_KEY
 A chave GetMiscStatus está ausente do registro.

Comentários

Os aplicativos de objeto podem pedir ao OLE para obter informações diversas status de uma das duas maneiras. Uma maneira é chamar OleRegGetMiscStatus. A outra é retornar OLE_S_USEREG em resposta a chamadas do manipulador de objeto padrão para IOleObject::GetMiscStatus. OLE_S_USEREG instrui o manipulador padrão a chamar OleRegGetMiscStatus. Como os aplicativos de objeto DLL não podem retornar OLE_S_USEREG, eles devem chamar OleRegGetMiscStatus em vez de delegar o trabalho para o manipulador de objetos.

OleRegGetMiscStatus e suas funções irmãos, OleRegGetUserType, OleRegEnumFormatEtc e OleRegEnumVerbs, fornecem uma maneira para os desenvolvedores de aplicativos de objeto DLL personalizados emularem o comportamento do manipulador de objetos padrão do OLE na obtenção de informações sobre objetos do registro. Ao usar essas funções, você evita o trabalho considerável de escrever o seu próprio e as armadilhas inerentes ao trabalho diretamente no Registro. Além disso, você obtém aprimoramentos futuros e otimizações dessas funções sem precisar codifique-as por conta própria.

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 ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-3 (introduzido no Windows 10, versão 10.0.10240)

Confira também

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType