Função OleRegEnumVerbs (ole2.h)

  • Artigo

Fornece uma enumeração dos verbos registrados para a classe especificada. Os desenvolvedores de aplicativos de objeto DLL personalizados usam essa função para emular o comportamento do manipulador de objetos padrão.

Sintaxe

HRESULT OleRegEnumVerbs(
  [in]  REFCLSID      clsid,
  [out] LPENUMOLEVERB *ppenum
);

Parâmetros

[in] clsid

Identificador de classe cujos verbos estão sendo solicitados.

[out] ppenum

Endereço da variável de ponteiro IEnumOLEVERB* que recebe o ponteiro de interface para o novo objeto de enumeração.

Retornar valor

Essa função retorna S_OK com êxito. Outros valores possíveis incluem o seguinte.

Código de retorno Descrição
OLEOBJ_E_NOVERBS
 Nenhum verbo é registrado para a classe .
REGDB_E_CLASSNOTREG
 Nenhum CLSID está registrado para o objeto de classe.
REGDB_E_READREGDB
 Ocorreu um erro ao ler o registro.
OLE_E_REGDB_KEY
 A chave DataFormats/GetSet está ausente do registro.

Comentários

Os aplicativos de objeto podem pedir ao OLE para criar um objeto de enumeração para estruturas OLEVERB para enumerar verbos com suporte de uma das duas maneiras. Uma maneira é chamar OleRegEnumVerbs. A outra maneira é retornar OLE_S_USEREG em resposta a chamadas do manipulador de objetos padrão para IOleObject::EnumVerbs. OLE_S_USEREG instrui o manipulador padrão a chamar OleRegEnumVerbs. Como os aplicativos de objeto DLL não podem retornar OLE_S_USEREG, eles devem chamar OleRegEnumVerbs em vez de delegar o trabalho para o manipulador de objetos. Com o ponteiro IEnumOLEVERB fornecido para o objeto , você pode chamar os métodos de objeto de enumeração padrão para fazer a enumeração.

A função OleRegEnumVerbs e suas funções irmãos, OleRegGetUserType, OleRegGetMiscStatus e OleRegEnumFormatEtc, 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

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 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

Ienumoleverb

IOleObject::EnumVerbs