Função SHStartNetConnectionDialogA (shlobj_core.h)

[SHStartNetConnectionDialog está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Exibe uma caixa de diálogo de navegação geral para uma conexão de recurso de rede.

Sintaxe

SHSTDAPI SHStartNetConnectionDialogA(
  [in, optional] HWND   hwnd,
  [in, optional] LPCSTR pszRemoteName,
                 DWORD  dwType
);

Parâmetros

[in, optional] hwnd

Digite: HWND

Um identificador para a janela pai.

[in, optional] pszRemoteName

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome da rede remota. Esse valor pode ser definido como NULL.

dwType

Tipo: DWORD

Um campo de bits que contém um conjunto de sinalizadores que identificam o tipo de recurso que a caixa de diálogo está definida para localizar. Esse valor pode conter um dos seguintes valores, definidos em Winnetwk.h:

RESOURCETYPE_ANY (0x00000000)

Todos os recursos

RESOURCETYPE_DISK (0x00000001)

Recursos de disco

RESOURCETYPE_PRINT (0x00000002)

Imprimir recursos

Retornar valor

Tipo: HRESULT

Sempre retorna S_OK.

Comentários

Observação

O cabeçalho shlobj_core.h define SHStartNetConnectionDialog como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h, Shlobj_core.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)