struttura KNOWNFOLDER_DEFINITION (shobjidl_core.h)

Definisce le specifiche di una cartella nota.

Sintassi

typedef struct KNOWNFOLDER_DEFINITION {
  KF_CATEGORY         category;
  LPWSTR              pszName;
  LPWSTR              pszDescription;
  KNOWNFOLDERID       fidParent;
  LPWSTR              pszRelativePath;
  LPWSTR              pszParsingName;
  LPWSTR              pszTooltip;
  LPWSTR              pszLocalizedName;
  LPWSTR              pszIcon;
  LPWSTR              pszSecurity;
  DWORD               dwAttributes;
  KF_DEFINITION_FLAGS kfdFlags;
  FOLDERTYPEID        ftidType;
} KNOWNFOLDER_DEFINITION;

Members

category

Tipo: KF_CATEGORY

Valore singolo delle costanti KF_CATEGORY che classificano la cartella come virtuale, fissa, comune o per utente.

pszName

Tipo: LPWSTR

Puntatore al nome canonico non localizzato per la cartella nota, archiviato come stringa Unicode con terminazione Null. Se questa cartella è una cartella comune o per utente, questo valore viene usato anche come nome valore delle impostazioni del Registro di sistema "Cartelle della shell utente". Questo nome deve essere un nome univoco leggibile. È consigliabile che terze parti seguano il formato Company.Application.Name. Il nome specificato qui non deve essere confuso con il nome visualizzato.

pszDescription

Tipo: LPWSTR

Puntatore a una breve descrizione della cartella nota, archiviata come stringa Unicode con terminazione Null. Questa descrizione deve includere lo scopo e l'utilizzo della cartella.

fidParent

Tipo: KNOWNFOLDERID

Valore KNOWNFOLDERID che assegna un nome a un'altra cartella nota da usare come cartella padre. Si applica solo alle cartelle comuni e per utente. Questo valore viene usato insieme a pszRelativePath. Per altri dettagli, vedere La sezione Osservazioni .

Questo valore è facoltativo se non viene fornito alcun valore per pszRelativePath.

pszRelativePath

Tipo: LPWSTR

facoltativo. Puntatore a un percorso relativo alla cartella padre specificata in fidParent. Si tratta di una stringa Unicode con terminazione Null, fa riferimento al percorso del file system fisico e non è localizzata. Si applica solo alle cartelle comuni e per utente. Per altri dettagli, vedere La sezione Osservazioni .

pszParsingName

Tipo: LPWSTR

Puntatore al percorso della cartella della cartella dello spazio dei nomi shell archiviato come stringa Unicode con terminazione Null. Si applica solo alle cartelle virtuali. Ad esempio, Control Panel ha un nome di analisi di ::%CLSID_MyComputer%::%CLSID_ControlPanel%.

pszTooltip

Tipo: LPWSTR

facoltativo. Puntatore alla risorsa della descrizione comando predefinita usata per questa cartella nota al momento della creazione. Stringa Unicode con terminazione Null in questo formato:

Nome modulo, ID risorsa

Ad esempio, @%_SYS_MOD_PATH%,-12688 è la descrizione comando per Immagini comuni. Quando viene creata la cartella, questa stringa viene archiviata nella copia di tale cartella di Desktop.ini. Può essere modificato in un secondo momento da altre API shell. Questa risorsa potrebbe essere localizzata.

Queste informazioni non sono necessarie per le cartelle virtuali.

pszLocalizedName

Tipo: LPWSTR

facoltativo. Puntatore alla risorsa nome localizzata predefinita usata quando viene creata la cartella. Stringa Unicode con terminazione Null in questo formato:

Nome modulo, ID risorsa

Quando viene creata la cartella, questa stringa viene archiviata nella copia di tale cartella di Desktop.ini. Può essere modificato in un secondo momento da altre API shell.

Queste informazioni non sono necessarie per le cartelle virtuali.

pszIcon

Tipo: LPWSTR

facoltativo. Puntatore alla risorsa icona predefinita usata al momento della creazione della cartella. Stringa Unicode con terminazione Null in questo formato:

Nome modulo, ID risorsa

Quando viene creata la cartella, questa stringa viene archiviata nella copia di tale cartella di Desktop.ini. Può essere modificato in un secondo momento da altre API shell.

Queste informazioni non sono necessarie per le cartelle virtuali.

pszSecurity

Tipo: LPWSTR

facoltativo. Puntatore a una stringa di formato del linguaggio di definizione del descrittore di sicurezza . Si tratta di una stringa Unicode con terminazione Null che descrive il descrittore di sicurezza predefinito ricevuto dalla cartella al momento della creazione. Se questo parametro è NULL, la nuova cartella eredita il descrittore di sicurezza del relativo padre. Ciò è particolarmente utile per le cartelle comuni a cui accedono tutti gli utenti.

dwAttributes

Tipo: DWORD

facoltativo. Attributi predefiniti del file system assegnati alla cartella al momento della creazione. Ad esempio, il file potrebbe essere nascosto e di sola lettura (FILE_ATTRIBUTE_HIDDEN e FILE_ATTRIBUTE_READONLY). Per un elenco completo dei valori possibili, vedere il parametro dwFlagsAndAttributes della funzione CreateFile . Impostare su -1 se non è necessario.

kfdFlags

Tipo: KF_DEFINITION_FLAGS

facoltativo. Uno degli altri valori dell'enumerazione KF_DEFINITION_FLAGS che consente di limitare il reindirizzamento, consentire il roaming da PC a PC e controllare l'ora in cui viene creata la cartella nota. Impostare su 0 se non necessario.

ftidType

Tipo: FOLDERTYPEID

Uno dei valori FOLDERTYPEID che identifica il tipo di cartella nota in base al contenuto,ad esempio documenti, musica o fotografie. Questo valore è un GUID.

Commenti

I valori fidParent e pszRelativePath interagiscono. Si supponga, ad esempio, di definire una cartella denominata MyNewFolder e di voler creare tale cartella come ...< Username>\AppData\Local\MyApp\MyNewFolder. Fornire FOLDERID_LocalAppData in fidParent per rappresentare ...< Nome utente>\AppData\Local. Specificare "\MyApp\MyNewFolder" in pszRelativePath.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

IKnownFolder::GetFolderDefinition

IKnownFolderManager::RegisterFolder

Esempio di cartelle note