Share via

Função PSRegisterPropertySchema (propsys.h)

  • Artigo

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

Sintaxe

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

Parâmetros

[in] pszPath

Tipo: PCWSTR

Ponteiro para o caminho completo do arquivo, como uma cadeia de caracteres Unicode, para o arquivo de esquema de descrição da propriedade (.propdesc) no computador local. Isso pode ser um caminho completo totalmente especificado ou um caminho completo que inclui variáveis de ambiente, como %PROGRAMFILES%.

Retornar valor

Tipo: HRESULT

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
 Todas as descrições de propriedade no esquema foram registradas.
E_ACCESSDENIED
 O contexto de chamada não tem privilégios adequados.
INPLACE_S_TRUNCATED
 Uma ou mais descrições de propriedade no esquema não foram registradas. As falhas específicas são registradas no log de eventos do aplicativo.

Comentários

Essa função é uma API de wrapper para a implementação do subsistema de esquema de IPropertySystem::RegisterPropertySchema. Chame essa função somente quando o arquivo for instalado pela primeira vez no computador. Normalmente, um aplicativo de instalação chama essa função 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 vários arquivos de esquema.

Ao registrar arquivos de esquema de propriedade, lembre-se de que eles podem ser lidos por processos em execução como usuários diferentes. Portanto, é importante colocar um arquivo de esquema em um local que conceda acesso de leitura a todos os usuários no computador. Da mesma forma, use o caminho absoluto para o arquivo no parâmetro pszPath dessa função.

Nota Como os esquemas são específicos do computador e não podem ser registrados para cada usuário individual, não há suporte para o registro de um caminho de arquivo em perfis de usuário no Windows Vista.
 
Se uma falha total ou parcial for encontrada que impede que uma descrição da propriedade seja carregada, a causa será registrada no log de eventos do aplicativo. Essa função falhará com E_ACCESSDENIED se o contexto de chamada não tiver privilégios adequados, o que inclui acesso de gravação a HKEY_LOCAL_MACHINE. É responsabilidade do aplicativo de chamada obter privilégios por meio de mecanismos de Controle de Conta de Usuário (UAC).

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
Biblioteca Propsys.lib
DLL Propsys.dll (versão 5.0 ou posterior)
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0