Compartilhar via

Método IPropertySystem::RegisterPropertySchema (propsys.h)

  • Artigo

Informa o subsistema de esquema da adição de um arquivo de esquema de descrição de propriedade.

Sintaxe

HRESULT RegisterPropertySchema(
  [in] LPCWSTR pszPath
);

Parâmetros

[in] pszPath

Tipo: LPCWSTR

Ponteiro para o caminho do arquivo .propdesc no computador local.

Retornar valor

Tipo: HRESULT

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
 Indica que o esquema está registrado.
E_ACCESSDENIED
 Indica que o contexto de chamada não tem privilégios adequados.
INPLACE_S_TRUNCATED
 Indica que uma ou mais das descrições de propriedade no esquema não foram registradas.

Comentários

Esse método informa o subsistema de esquema da adição de um arquivo de esquema de descrição de propriedade (.propdesc), usando um caminho de arquivo para o arquivo .propdesc no computador local. Chame esse método somente quando o arquivo tiver sido instalado pela primeira vez no computador. Normalmente, um aplicativo de instalação chama esse método depois de instalar o arquivo .propdesc, que deve ser armazenado no diretório de instalação do aplicativo em "Arquivos de Programas". Várias chamadas podem ser feitas para IPropertySystem::RegisterPropertySchema para registrar em lote vários arquivos de esquema.

Se for encontrada uma falha que impede que uma descrição da propriedade seja carregada, a causa será registrada no log de eventos do aplicativo. Esse método falhará com E_ACCESSDENIED se o contexto de chamada não tiver privilégios adequados, que incluem acesso de gravação ao HKLM (HKEY_LOCAL_MACHINE). É responsabilidade do aplicativo de chamada obter privilégios por meio de mecanismos de conta de usuário limitada (LUA).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho propsys.h
DLL Propsys.dll (versão 5.0 ou posterior)
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0

Confira também

IPropertySystem