CoRevokeClassObject
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função informa OLE que um objeto classe, previamente registrado com o CoRegisterClassObject função, é não mais disponível para uso.
Syntax
HRESULT CoRevokeClassObject(
DWORD dwRegister
);
Parameters
- dwRegister
[no] Símbolo anteriormente retornado do CoRegisterClassObject função.
Return Value
O padrão oferece suporte a essa função retornar valores E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, bem como o seguinte:
- S_OK
O objeto classe com êxito foi revogado.
Remarks
Um bem-sucedido chamar para CoRevokeClassObject significa que o objeto classe tem sido removido da tabela de objeto global classe (embora ele não versão o objeto classe).
Se outros clientes ainda terá os ponteiros para o objeto classe e ter causado o contagem de referência para ser incrementado por chamadas para IUnknown::AddRef, o contagem de referência não será zero. Quando isso ocorrer, aplicativos pode beneficiar se subseqüentes chamadas (com as exceções óbvias de IUnknown::AddRef e IUnknown::Release) para o objeto classe falhar.
Um aplicativo objeto deve chamar CoRevokeClassObject Para revogar classe registrado objetos antes de sair de programa. Classe objeto implementadores devem chamar CoRevokeClassObject Como parte da seqüência de versão.
O aplicativo especificamente deve revogar o objeto classe mesmo se ele tiver especificado o Sinalizadores valor REGCLS_SINGLEUSE em um chamar para CoRegisterClassObject, indicando que somente um aplicativo pode conectar para o objeto classe.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |