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

Consulte también

IKnownFolder

Ejemplo de carpetas conocidas

SHSetKnownFolderPath