Metodo IKnownFolder::SetPath (shobjidl_core.h)
Assegna un nuovo percorso a una cartella nota.
Sintassi
HRESULT SetPath(
[in] DWORD dwFlags,
[in] LPCWSTR pszPath
);
Parametri
[in] dwFlags
Tipo: DWORD
Zero o il valore seguente:
KF_FLAG_DONT_UNEXPAND
Impostare il percorso completo senza stringhe di ambiente. Se questo flag non è impostato, le parti del percorso in pszPath possono essere rappresentate da stringhe di ambiente, ad %USERPROFILE%esempio .
[in] pszPath
Tipo: LPCWSTR
Puntatore al nuovo percorso della cartella. Stringa Unicode con terminazione Null MAX_PATH. Questo percorso non può essere di lunghezza zero. Se questo valore è NULL, IKnownFolder::SetPath imposta il percorso sul valore predefinito.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Questo metodo non può essere chiamato nelle cartelle di tipo KF_CATEGORY_FIXED o KF_CATEGORY_VIRTUAL.
Per chiamare questo metodo in una cartella di tipo KF_CATEGORY_COMMON, l'applicazione chiamante deve essere in esecuzione con privilegi elevati.
Questo metodo equivale a SHSetKnownFolderPath.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |