Método IKnownFolder::SetPath (shobjidl_core.h)
Asigna una nueva ruta de acceso a una carpeta conocida.
Sintaxis
HRESULT SetPath(
[in] DWORD dwFlags,
[in] LPCWSTR pszPath
);
Parámetros
[in] dwFlags
Tipo: DWORD
Cero o el valor siguiente:
KF_FLAG_DONT_UNEXPAND
Establezca la ruta de acceso completa sin cadenas de entorno. Si no se establece esta marca, las partes de la ruta de acceso en pszPath se pueden representar mediante cadenas de entorno como %USERPROFILE%.
[in] pszPath
Tipo: LPCWSTR
Puntero a la nueva ruta de acceso de la carpeta. Se trata de una cadena Unicode terminada en NULL de longitud MAX_PATH. Esta ruta de acceso no puede tener una longitud cero. Si este valor es NULL, IKnownFolder::SetPath establece la ruta de acceso al valor predeterminado.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
No se puede llamar a este método en carpetas de tipo KF_CATEGORY_FIXED o KF_CATEGORY_VIRTUAL.
Para llamar a este método en una carpeta de tipo KF_CATEGORY_COMMON, la aplicación que realiza la llamada debe ejecutarse con privilegios elevados.
Este método es equivalente a SHSetKnownFolderPath.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |
| Archivo DLL | Shell32.dll |