Compartir a través de

Función PSRegisterPropertySchema (propsys.h)

  • Artículo

Informa al subsistema de esquema de la adición de un archivo de esquema de descripción de propiedad.

Sintaxis

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

Parámetros

[in] pszPath

Tipo: PCWSTR

Puntero a la ruta de acceso completa del archivo, como una cadena Unicode, al archivo de esquema de descripción de propiedad (.propdesc) en el equipo local. Puede ser una ruta de acceso completa totalmente especificada o una ruta de acceso completa que incluya variables de entorno como %PROGRAMFILES%.

Valor devuelto

Tipo: HRESULT

Devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
 Todas las descripciones de propiedades del esquema se registraron.
E_ACCESSDENIED
 El contexto de llamada no tiene privilegios adecuados.
INPLACE_S_TRUNCATED
 No se pudo registrar una o varias descripciones de propiedades en el esquema. Los errores específicos se registran en el registro de eventos de la aplicación.

Comentarios

Esta función es una API contenedora para la implementación del subsistema de esquema de IPropertySystem::RegisterPropertySchema. Llame a esta función solo cuando el archivo se instale por primera vez en el equipo. Normalmente, una aplicación de instalación llama a esta función después de instalar el archivo .propdesc, que se debe almacenar en el directorio de instalación de la aplicación en Archivos de programa. Se pueden realizar varias llamadas a IPropertySystem::RegisterPropertySchema para registrar varios archivos de esquema.

Al registrar archivos de esquema de propiedades, recuerde que se pueden leer mediante procesos que se ejecutan como usuarios diferentes. Por lo tanto, es importante colocar un archivo de esquema en una ubicación que conceda acceso de lectura a todos los usuarios de la máquina. Del mismo modo, use la ruta de acceso absoluta al archivo en el parámetro pszPath de esta función.

Nota Dado que los esquemas son específicos de la máquina y no se pueden registrar para cada usuario individual, no se admite el registro de una ruta de acceso de archivo en perfiles de usuario en Windows Vista.
 
Si se encuentra un error completo o parcial que impide que se cargue una descripción de propiedad, la causa se registra en el registro de eventos de la aplicación. Se produce un error en esta función con E_ACCESSDENIED si el contexto de llamada no tiene privilegios adecuados, lo que incluye el acceso de escritura a HKEY_LOCAL_MACHINE. Es responsabilidad de la aplicación que realiza la llamada obtener privilegios a través de mecanismos de control de cuentas de usuario (UAC).

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado propsys.h
Library Propsys.lib
Archivo DLL Propsys.dll (versión 5.0 o posterior)
Redistribuible Windows Desktop Search (WDS) 3.0