Função OleRegEnumVerbs (ole2.h)
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 |
|---|---|
|
Nenhum verbo é registrado para a classe . |
|
Nenhum CLSID está registrado para o objeto de classe. |
|
Ocorreu um erro ao ler o registro. |
|
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) |