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

Registra 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 RegisterCategories(
  [in] ULONG           cCategories,
  [in] CATEGORYINFO [] rgCategoryInfo
);

Parâmetros

[in] cCategories

O número de categorias de componente a serem registradas.

[in] rgCategoryInfo

Uma matriz de estruturas CATEGORYINFO , uma para cada categoria a ser registrada. Ao fornecer o mesmo CATID para várias estruturas CATEGORYINFO , várias localidades podem ser registradas para a mesma categoria de componente.

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 só pode ser chamado pelo proprietário de uma categoria, geralmente como parte da instalação ou desinstalação do sistema operacional ou aplicativo.

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