Estrutura NETRESOURCEA (winnetwk.h)

  • Artigo

A estrutura a seguir contém informações sobre um recurso de rede. Ele é usado por várias das funções de provedor de rede, incluindo NPOpenEnum e NPAddConnection.

Sintaxe

typedef struct _NETRESOURCEA {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  LPSTR lpComment;
  LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;

Membros

dwScope

Indica o escopo da enumeração. Esse pode ser um dos valores a seguir.

Valor Significado
RESOURCE_CONNECTED
 Conexões atuais com recursos de rede.
RESOURCE_GLOBALNET
 Todos os recursos de rede. Eles podem ou não estar conectados.
RESOURCE_CONTEXT
 Os recursos de rede associados ao contexto de rede atual e padrão do usuário. O significado disso é específico do provedor.

dwType

Indica o tipo de recurso. Esse pode ser um dos valores a seguir.

Valor Significado
RESOURCETYPE_DISK
 O recurso é um volume de disco compartilhado.
RESOURCETYPE_PRINT
 O recurso é uma impressora compartilhada.
RESOURCETYPE_ANY
 O recurso corresponde a mais de um tipo, por exemplo, um contêiner de recursos de impressão e disco ou um recurso que não é impresso ou disco.

dwDisplayType

Defina pelo provedor para indicar qual tipo de exibição uma interface do usuário deve usar para representar esse recurso. Os tipos a seguir são definidos.

Valor Significado
RESOURCEDISPLAYTYPE_NETWORK
 O recurso é um provedor de rede.
RESOURCEDISPLAYTYPE_DOMAIN
 O recurso é uma coleção de servidores.
RESOURCEDISPLAYTYPE_SERVER
 O recurso é um servidor.
RESOURCEDISPLAYTYPE_SHARE
 O recurso é um ponto de compartilhamento.
RESOURCEDISPLAYTYPE_DIRECTORY
 O recurso é um diretório.
RESOURCEDISPLAYTYPE_GENERIC
 O tipo de recurso não é especificado. Esse valor é usado por provedores de rede que não especificam tipos de recursos.

dwUsage

Uma máscara de bits que indica como você pode enumerar informações sobre o recurso. Ele será definido somente se dwScope estiver definido como RESOURCE_GLOBALNET. O campo dwUsage pode conter um ou mais dos sinalizadores a seguir.

Valor Significado
RESOURCEUSAGE_CONNECTABLE
 Você pode se conectar ao recurso chamando NPAddConnection. Se dwType for RESOURCETYPE_DISK, depois de se conectar ao recurso, você poderá usar as APIs do sistema de arquivos, como FindFirstFile e FindNextFile, para enumerar todos os arquivos e diretórios que o recurso contém.
RESOURCEUSAGE_CONTAINER
 O recurso é um contêiner para outros recursos que podem ser enumerados por meio das funções NPOpenEnum, NPEnumResource e NPCloseEnum .

No entanto, o contêiner pode estar vazio no momento em que a enumeração é feita. Em outras palavras, a primeira chamada para NPEnumResource pode retornar WN_NO_MORE_ENTRIES.

lpLocalName

Se dwScope for RESOURCE_CONNECTED, o campo lpLocalName conterá o nome de um dispositivo redirecionado. Se a conexão for uma conexão sem dispositivo, esse campo conterá NULL.

Se dwScope não estiver definido como RESOURCE_CONNECTED, esse campo será indefinido.

lpRemoteName

Se o item enumerado for um recurso de rede, esse campo conterá um nome de rede remota. Esse nome poderá ser passado para NPAddConnection para fazer uma conexão de rede se dwUsage estiver definido como RESOURCEUSAGE_CONNECTABLE. Se o item enumerado for uma conexão atual, esse campo se referirá ao nome de rede remota ao qual lpLocalName está conectado.

lpComment

Pode ser qualquer comentário fornecido pelo provedor associado ao item enumerado.

lpProvider

Especifica o nome do provedor que possui esse item enumerado.

Comentários

Observação

O cabeçalho winnetwk.h define NETRESOURCE 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

   
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]
Cabeçalho winnetwk.h