Método IKnownFolderManager::Redirect (shobjidl_core.h)

Artículo
03/02/2024

Redirige las solicitudes de carpeta para carpetas comunes y por usuario.

Sintaxis

HRESULT Redirect(
  [in]           REFKNOWNFOLDERID    rfid,
  [in, optional] HWND                hwnd,
  [in]           KF_REDIRECT_FLAGS   flags,
  [in, optional] LPCWSTR             pszTargetPath,
  [in]           UINT                cFolders,
  [in]           const KNOWNFOLDERID *pExclusion,
  [out]          LPWSTR              *ppszError
);

Parámetros

[in] rfid

Tipo: REFKNOWNFOLDERID

Referencia a KNOWNFOLDERID de la carpeta que se va a redirigir.

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria usada para mostrar los cuadros de diálogo de la interfaz de usuario de progreso del motor de copia cuando se pasa KF_REDIRECT_WITH_UI en el parámetro flags . Si no se necesita ningún cuadro de diálogo de progreso, este valor puede ser NULL.

[in] flags

Tipo: KF_REDIRECT_FLAGS

Las opciones de KF_REDIRECT_FLAGS para el redireccionamiento.

[in, optional] pszTargetPath

Tipo: LPCWSTR

Puntero a la nueva ruta de acceso de la carpeta. Se trata de una cadena Unicode terminada en null. Este valor puede ser NULL.

[in] cFolders

Tipo: UINT

Número de valores KNOWNFOLDERID de la matriz en pExclusion.

[in] pExclusion

Tipo: KNOWNFOLDERID const*

Puntero a una matriz de valores KNOWNFOLDERID que hacen referencia a subcarpetas de rfid que se deben excluir del redireccionamiento. Si no se excluye ninguna subcarpeta, este valor puede ser NULL.

[out] ppszError

Tipo: LPWSTR*

Cuando este método devuelve , contiene la dirección de un puntero a una cadena Unicode terminada en null que contiene un mensaje de error si se generó uno. Este valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error, incluido lo siguiente:

Código devuelto	Descripción
E_INVALIDARG	Entre otras cosas, este valor puede indicar que el parámetro rfid hace referencia a un KNOWNFOLDERID que no está presente en el sistema. No todos los valores KNOWNFOLDERID están presentes en todos los sistemas. Use IKnownFolderManager::GetFolderIds para recuperar el conjunto de valores KNOWNFOLDERID para el sistema actual.

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 (incluya Shobjidl.h)

Consulte también

IKnownFolderManager

Ejemplo de carpetas conocidas