Método IKnownFolderManager::RegisterFolder (shobjidl_core.h)

  • Artículo

Agrega una nueva carpeta conocida al Registro. Se usa especialmente por proveedores de software independientes (ISV) que agregan una de sus propias carpetas al sistema de carpetas conocido.

Sintaxis

HRESULT RegisterFolder(
  [in] REFKNOWNFOLDERID             rfid,
  [in] const KNOWNFOLDER_DEFINITION *pKFD
);

Parámetros

[in] rfid

Tipo: REFKNOWNFOLDERID

GUID que representa la carpeta conocida.

[in] pKFD

Tipo: const KNOWNFOLDER_DEFINITION*

Puntero a una estructura de KNOWNFOLDER_DEFINITION válida que proporciona los detalles de la nueva carpeta.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Nota Este método actualiza HKEY_LOCAL_MACHINE y, por tanto, debe ejecutarse en el contexto de un administrador. Los programas de instalación necesitan privilegios de administrador para registrar o anular el registro de una carpeta conocida.
 
IKnownFolderManager::RegisterFolder intenta comprobar que el nuevo KNOWNFOLDERID no hace referencia a una ruta de acceso del sistema de archivos ya apuntada por un KNOWNFOLDERID existente. Si se encuentra el nuevo KNOWNFOLDERID para hacerlo, se produce un error en este método.

Varios valores KNOWNFOLDERID para la misma ruta de acceso del sistema de archivos pueden causar varios problemas, como conflictos en el archivo Desktop.ini que provocan confusión en cuanto al idioma o las propiedades que se van a mostrar para la carpeta. Varios valores KNOWNFOLDERID también pueden causar confusión en cuanto a la ruta de acceso de la barra de direcciones o a qué tareas mostrar para la carpeta en el Explorador de Windows.

Puede suprimir la presentación de la página Personalizar de la ventana Propiedades de la carpeta conocida. Para ello, establezca el siguiente valor de REG_DWORD del Registro:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  FolderDescriptions
                     Folder GUID
                        PropertyBag
                           NoCustomize = 0x00000001 (1)

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Archivo DLL Shell32.dll

Consulte también

IKnownFolderManager

IKnownFolderManager::UnregisterFolder

Ejemplo de carpetas conocidas