Metodo IKnownFolderManager::RegisterFolder (shobjidl_core.h)

Articolo
08/26/2023

Aggiunge una nuova cartella nota al Registro di sistema. Usato in particolare dai fornitori di software indipendenti (ISV) che aggiungono una delle proprie cartelle al sistema di cartelle note.

Sintassi

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

Parametri

[in] rfid

Tipo: REFKNOWNFOLDERID

GUID che rappresenta la cartella nota.

[in] pKFD

Tipo: const KNOWNFOLDER_DEFINITION*

Puntatore a una struttura di KNOWNFOLDER_DEFINITION valida che fornisce i dettagli della nuova cartella.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Nota Questo metodo aggiorna HKEY_LOCAL_MACHINE e pertanto deve essere eseguito nel contesto di un amministratore. I programmi di installazione richiedono privilegi di amministratore per registrare o annullare la registrazione di una cartella nota.

IKnownFolderManager::RegisterFolder tenta di verificare che il nuovo KNOWNFOLDERID non faccia riferimento a un percorso del file system già indicato da un KNOWNFOLDERID esistente. Se viene trovato il nuovo KNOWNFOLDERID , questo metodo ha esito negativo.

Più valori KNOWNFOLDERID per lo stesso percorso del file system possono causare diversi problemi, ad esempio conflitti nel file Desktop.ini che causano confusione in base alla lingua o alle proprietà da visualizzare per la cartella. Più valori KNOWNFOLDERID possono anche causare confusione sul percorso della barra degli indirizzi o sulle attività da visualizzare per la cartella in Esplora risorse.

È possibile eliminare la visualizzazione della pagina Personalizza della Finestra Proprietà della cartella nota. A tale scopo, impostare il valore di REG_DWORD del Registro di sistema seguente:

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

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll

Vedi anche

IKnownFolderManager

IKnownFolderManager::UnregisterFolder

Esempio di cartelle note

Condividi tramite