Função WNetOpenEnumA (winnetwk.h)

Artigo
03/08/2023

A função WNetOpenEnum inicia uma enumeração de recursos de rede ou conexões existentes. Você pode continuar a enumeração chamando a função WNetEnumResource .

Sintaxe

DWORD WNetOpenEnumA(
  [in]  DWORD          dwScope,
  [in]  DWORD          dwType,
  [in]  DWORD          dwUsage,
  [in]  LPNETRESOURCEA lpNetResource,
  [out] LPHANDLE       lphEnum
);

Parâmetros

[in] dwScope

Escopo da enumeração. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
RESOURCE_CONNECTED	Enumerar todos os recursos conectados no momento. A função ignora o parâmetro dwUsage . Para obter mais informações, consulte a seção Comentários a seguir.
RESOURCE_CONTEXT	Enumerar somente recursos no contexto de rede do chamador. Especifique esse valor para uma exibição de Bairro de Rede. A função ignora o parâmetro dwUsage .
RESOURCE_GLOBALNET	Enumerar todos os recursos na rede.
RESOURCE_REMEMBERED	Enumerar todas as conexões (persistentes) lembradas. A função ignora o parâmetro dwUsage .

[in] dwType

Tipos de recursos a serem enumerados. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor	Significado
RESOURCETYPE_ANY	Todos os recursos. Esse valor não pode ser combinado com RESOURCETYPE_DISK ou RESOURCETYPE_PRINT.
RESOURCETYPE_DISK	Todos os recursos de disco.
RESOURCETYPE_PRINT	Todos os recursos de impressão.

Se um provedor de rede não puder distinguir entre recursos de impressão e disco, ele poderá enumerar todos os recursos.

[in] dwUsage

Tipo de uso de recurso a ser enumerado. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor	Significado
0	Todos os recursos.
RESOURCEUSAGE_CONNECTABLE	Todos os recursos conectáveis.
RESOURCEUSAGE_CONTAINER	Todos os recursos de contêiner.
RESOURCEUSAGE_ATTACHED	A configuração desse valor força o WNetOpenEnum a falhar se o usuário não estiver autenticado. A função falhará mesmo que a rede permita a enumeração sem autenticação.
RESOURCEUSAGE_ALL	Definir esse valor é equivalente a definir RESOURCEUSAGE_CONNECTABLE, RESOURCEUSAGE_CONTAINER e RESOURCEUSAGE_ATTACHED.

Esse parâmetro é ignorado, a menos que o parâmetro dwScope seja igual a RESOURCE_GLOBALNET. Para obter mais informações, consulte a seção Comentários a seguir.

[in] lpNetResource

Ponteiro para uma estrutura NETRESOURCE que especifica o contêiner a ser enumerado. Se o parâmetro dwScope não for RESOURCE_GLOBALNET, esse parâmetro deverá ser NULL.

Se esse parâmetro for NULL, a raiz da rede será assumida. (O sistema organiza uma rede como uma hierarquia; a raiz é o contêiner mais alto da rede.)

Se esse parâmetro não for NULL, ele deverá apontar para uma estrutura NETRESOURCE . Essa estrutura pode ser preenchida pelo aplicativo ou pode ser retornada por uma chamada para a função WNetEnumResource . A estrutura NETRESOURCE deve especificar um recurso de contêiner; ou seja, o valor RESOURCEUSAGE_CONTAINER deve ser especificado no parâmetro dwUsage .

Para enumerar todos os recursos de rede, um aplicativo pode iniciar a enumeração chamando WNetOpenEnum com o parâmetro lpNetResource definido como NULL e, em seguida, usar o identificador retornado para chamar WNetEnumResource para enumerar recursos. Se um dos recursos na matriz NETRESOURCE retornado pela função WNetEnumResource for um recurso de contêiner, você poderá chamar WNetOpenEnum para abrir o recurso para enumeração adicional.

[out] lphEnum

Ponteiro para um identificador de enumeração que pode ser usado em uma chamada subsequente para WNetEnumResource.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um código de erro do sistema, como um dos valores a seguir.

Código de retorno	Descrição
ERROR_NOT_CONTAINER	O parâmetro lpNetResource não aponta para um contêiner.
ERROR_INVALID_PARAMETER	O dwScope ou o parâmetro dwType são inválidos ou há uma combinação inválida de parâmetros.
ERROR_NO_NETWORK	A rede não está disponível.
ERROR_EXTENDED_ERROR	Ocorreu um erro específico da rede. Para obter uma descrição do erro, chame a função WNetGetLastError .
ERROR_INVALID_ADDRESS	Um nome de recurso de rede remota fornecido na estrutura NETRESOURCE resolvido para um endereço de rede inválido.

Comentários

Se o parâmetro dwScope for igual a RESOURCE_CONNECTED, uma conexão de rede feita usando a rede do Microsoft LAN Manager será omitida da enumeração se a conexão tiver sido feita por um aplicativo em execução em uma sessão de logon diferente do aplicativo que chama a função WNetOpenEnum . Isso ocorre porque as conexões feitas usando o Microsoft LAN Manager são visíveis apenas para aplicativos em execução na mesma sessão de logon que o aplicativo que fez a conexão. (Para incluir a conexão na enumeração, não é suficiente que o aplicativo esteja em execução na conta de usuário que criou a conexão.)

A interpretação exata de RESOURCE_CONTEXT no parâmetro dwScope depende das redes instaladas no computador.

A função WNetOpenEnum é usada para iniciar a enumeração dos recursos em um único contêiner. Os exemplos a seguir mostram a estrutura hierárquica de uma rede do Microsoft LAN Manager e uma rede Novell NetWare e identificam os contêineres.

LanMan (container, in this case the provider) 
  ACCOUNTING (container, in this case the domain) 
    \\ACCTSPAY (container, in this case the server) 
      PAYFILES (disk) 
      LASERJET (print) 
 
NetWare (container, in this case the provider) 
  MARKETING (container, in this case the server) 
    SYS (disk, first one on any NetWare server) 
    ANOTHERVOLUME (disk) 
    LASERJET (print)

Exemplos

Para obter um exemplo de código que ilustra uma função definida pelo aplicativo que enumera todos os recursos em uma rede, consulte Enumerando Recursos de Rede.

Observação

O cabeçalho winnetwk.h define WNetOpenEnum 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 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winnetwk.h
Biblioteca	Mpr.lib
DLL	Mpr.dll