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

Vedi anche

IKnownFolder

Esempio di cartelle note

SHSetKnownFolderPath