Função SHStartNetConnectionDialogA (shlobj_core.h)

Artigo
11/20/2024

[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

Tipo: 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

Valor de retorno

Tipo: HRESULT

Sempre retorna S_OK.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Compartilhar via