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