Compartir a través de

Función SHStartNetConnectionDialogA (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 SHStartNetConnectionDialogA(
  [in, optional] HWND   hwnd,
  [in, optional] LPCSTR pszRemoteName,
                 DWORD  dwType
);

Parámetros

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria.

[in, optional] pszRemoteName

Tipo: LPCTSTR de

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 de

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.

Observaciones

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de shlobj_core.h (incluya Shlobj.h, Shlobj_core.h)
biblioteca de Shell32.lib
DLL de Shell32.dll (versión 5.0 o posterior)