Función SHStartNetConnectionDialogW (shlobj_core.h)

  • Artículo

[SHStartNetConnectionDialog está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Muestra un cuadro de diálogo de exploración general para una conexión de recursos de red.

Sintaxis

SHSTDAPI SHStartNetConnectionDialogW(
  [in, optional] HWND    hwnd,
  [in, optional] LPCWSTR pszRemoteName,
                 DWORD   dwType
);

Parámetros

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria.

[in, optional] pszRemoteName

Tipo: LPCTSTR

Puntero a una cadena de caracteres terminada en null que especifica el nombre de red remota. Este valor se puede establecer en NULL.

dwType

Tipo: DWORD

Campo de bits que contiene un conjunto de marcas que identifican el tipo de recurso que el cuadro de diálogo está establecido para buscar. Este valor puede contener uno de los siguientes valores, definidos en Winnetwk.h:

RESOURCETYPE_ANY (0x00000000)

Todos los recursos

RESOURCETYPE_DISK (0x00000001)

Recursos de disco

RESOURCETYPE_PRINT (0x00000002)

Imprimir recursos

Valor devuelto

Tipo: HRESULT

Siempre devuelve S_OK.

Comentarios

Nota

El encabezado shlobj_core.h define SHStartNetConnectionDialog como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de funció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 shlobj_core.h (incluya Shlobj.h, Shlobj_core.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)