Método ICatRegister::UnRegisterCategories (comcat.h)

Remove o registro de uma ou mais categorias de componente. Cada categoria de componente consiste em um CATID e uma lista de cadeias de caracteres de descrição dependentes de localidade.

Sintaxe

HRESULT UnRegisterCategories(
  [in] ULONG    cCategories,
  [in] CATID [] rgcatid
);

Parâmetros

[in] cCategories

O número de categorias a serem removidas.

[in] rgcatid

Os CATIDs das categorias a serem removidas.

Retornar valor

Esse método pode retornar os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_INVALIDARG	Um ou mais argumentos estão incorretos.

Comentários

Esse método será bem-sucedido mesmo que uma ou mais das IDs de categoria especificadas não sejam registradas. Esse método só pode ser chamado pelo proprietário de uma categoria, geralmente como parte da instalação ou desinstalação do sistema operacional ou aplicativo.

Esse método não remove as marcas de categoria de componente de classes individuais. Para fazer isso, use o método ICatRegister::UnRegisterClassReqCategories .

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	comcat.h

Confira também

ICatRegister