Função OleRegGetMiscStatus (ole2.h)
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 |
|---|---|
|
As informações de status foram retornadas com êxito. |
|
Nenhum CLSID está registrado para o objeto de classe. |
|
Houve um erro ao ler do registro. |
|
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) |