Método INamespaceWalk::Walk (shobjidl_core.h)
Inicia un recorrido recursivo del espacio de nombres de la raíz especificada a la profundidad especificada.
Sintaxis
HRESULT Walk(
[in] IUnknown *punkToWalk,
[in] DWORD dwFlags,
[in] int cDepth,
[in] INamespaceWalkCB *pnswcb
);
Parámetros
[in] punkToWalk
Tipo: IUnknown*
Nodo raíz desde el que se va a comenzar el recorrido. Esto se puede representar mediante uno de los siguientes objetos.
Especificar el IShellFolder del escritorio como raíz permite recorrer todo el espacio de nombres de Windows si cDepth es lo suficientemente grande.[in] dwFlags
Tipo: DWORD
Una o varias de las marcas siguientes que controlan la operación walk.
NSWF_DEFAULT (0x00000000)
Use este valor cuando no desee establecer ninguna de las otras marcas.
NSWF_NONE_IMPLIES_ALL (0x00000001)
Recopile todos los elementos de la carpeta si se cumplen ambos criterios:
- punkToWalk es una carpeta (IShellFolder o IShellView).
- Ninguno de los elementos de la carpeta está seleccionado actualmente.
NSWF_ONE_IMPLIES_ALL (0x00000002)
Recopile todos los elementos de la carpeta si se cumplen ambos criterios:
- punkToWalk es una carpeta (IShellFolder o IShellView).
- Uno de los elementos de la carpeta está seleccionado actualmente.
NSWF_DONT_TRAVERSE_LINKS (0x00000004)
No siga los vínculos (.lnk, .url y accesos directos de carpeta) en la recursividad; en su lugar, los devuelve como elementos normales.
NSWF_DONT_ACCUMULATE_RESULT (0x00000008)
No recopile las PIDL de los nodos durante el recorrido del espacio de nombres.
NSWF_TRAVERSE_STREAM_JUNCTIONS (0x00000010)
Incluya el contenido de los puntos de unión del flujo en el paseo. Por ejemplo, vaya al contenido de un archivo .cab.
NSWF_FILESYSTEM_ONLY (0x00000020)
Recorrer solo los nodos del sistema de archivos.
NSWF_SHOW_PROGRESS (0x00000040)
Muestra un cuadro de diálogo con una barra de progreso mientras camina el espacio de nombres.
NSWF_FLAG_VIEWORDER (0x00000080)
Devuelve elementos en orden de vista. Esto solo se aplica cuando punkToWalk es un objeto IShellView .
NSWF_IGNORE_AUTOPLAY_HIDA (0x00000100)
No use el HIDA de Reproducción automática en el objeto de datos. Esto solo se aplica cuando punkToWalk es un objeto IDataObject .
NSWF_ASYNC (0x00000200)
Realice el recorrido de forma asincrónica ejecutándolo en un subproceso en segundo plano.
NSWF_DONT_RESOLVE_LINKS (0x00000400)
Recorra los vínculos para devolver sus destinos (para .lnk, .url y accesos directos de carpeta), pero no compruebe que esos destinos existen (Resolver). Se trata de una optimización y no afecta a los resultados, excepto en el caso de que se encuentre y devuelva un destino que falta o se ha movido.
NSWF_ACCUMULATE_FOLDERS (0x00000800)
NSWF_DONT_SORT (0x00001000)
No mantenga el criterio de ordenación de los elementos que se van a recorrer.
NSWF_USE_TRANSFER_MEDIUM (0x00002000)
NSWF_DONT_TRAVERSE_STREAM_JUNCTIONS (0x00004000)
NSWF_ANY_IMPLIES_ALL (0x00008000)
Introducido en Windows 8.
[in] cDepth
Tipo: int
Profundidad máxima que se va a descender a través de la jerarquía del espacio de nombres. Esta profundidad es de base cero. Establezca en 0 para recorrer solo la carpeta identificada por punkToWalk , pero ninguna de sus subcarpetas.
[in] pnswcb
Tipo: INamespaceWalkCB*
Función de devolución de llamada INamespaceWalkCB usada por INamespaceWalk. Este parámetro puede ser NULL. El objeto puede implementar opcionalmente las interfaces INamespaceWalkCB2 e IActionProgress . Vea los comentarios más abajo.
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
Si no pasa la marca NSWF_SHOW_PROGRESS y el objeto al que apunta el parámetro pnswcb implementa IActionProgress, el método INamespaceWalk::Walk llama al método IActionProgress::QueryCancel periódicamente para determinar si se debe cancelar la operación.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (incluya Shobjidl.h) |
| Library | Shell32.lib |
| Archivo DLL | Shell32.dll (versión 6.0 o posterior) |