Compartilhar via

Estrutura NETINFOSTRUCT (winnetwk.h)

  • Artigo

A estrutura NETINFOSTRUCT contém informações que descrevem o provedor de rede retornado pela função WNetGetNetworkInformation .

Sintaxe

typedef struct _NETINFOSTRUCT {
  DWORD     cbStructure;
  DWORD     dwProviderVersion;
  DWORD     dwStatus;
  DWORD     dwCharacteristics;
  ULONG_PTR dwHandle;
  WORD      wNetType;
  DWORD     dwPrinters;
  DWORD     dwDrives;
} NETINFOSTRUCT, *LPNETINFOSTRUCT;

Membros

cbStructure

Tipo: DWORD

O tamanho, em bytes, da estrutura NETINFOSTRUCT . O chamador deve fornecer esse valor para indicar o tamanho da estrutura passada. Após o retorno, ele tem o tamanho da estrutura preenchida.

dwProviderVersion

Tipo: DWORD

O número de versão do software do provedor de rede.

dwStatus

Tipo: DWORD

O status atual do software do provedor de rede. Esse membro pode ser um dos valores a seguir.

Valor Significado
NO_ERROR
 A rede está em execução.
ERROR_NO_NETWORK
 A rede não está disponível.
ERROR_BUSY
 No momento, a rede não é capaz de atender às solicitações, mas deve ficar disponível em breve. (Esse valor normalmente indica que a rede está sendo iniciada.)

dwCharacteristics

Tipo: DWORD

Características do software do provedor de rede.

Esse valor é zero.

Windows Me/98/95: Esse membro pode ser um ou mais dos valores a seguir.

Valor Significado
NETINFO_DLL16
 O provedor de rede está em execução como um driver de rede windows de 16 bits.
NETINFO_DISKRED
 O provedor de rede requer um dispositivo de unidade de disco local redirecionado para acessar sistemas de arquivos de servidor.
NETINFO_PRINTERRED
 O provedor de rede requer uma porta de impressora local redirecionada para acessar sistemas de arquivos de servidor.

dwHandle

Tipo: ULONG_PTR

Um identificador de instância para o provedor de rede ou para o driver de rede do Windows de 16 bits.

wNetType

Tipo: WORD

O tipo de rede exclusivo para a rede em execução. Esse valor associa recursos a uma rede específica quando os recursos são persistentes ou armazenados em links. Você pode encontrar uma lista completa de tipos de rede no arquivo de cabeçalho Winnetwk.h.

dwPrinters

Tipo: DWORD

Um conjunto de sinalizadores de bits que indica os números de impressão válidos para redirecionar dispositivos de impressora local, com o bit de baixa ordem correspondente ao LPT1.

Windows Me/98/95: Esse valor é sempre definido como –1.

dwDrives

Tipo: DWORD

Um conjunto de sinalizadores de bits que indica os dispositivos de disco locais válidos para redirecionar unidades de disco, com o bit de baixa ordem correspondente a A:.

Windows Me/98/95: Esse valor é sempre definido como –1.

Comentários

A estrutura NETINFOSTRUCT contém informações que descrevem a rede, como a versão do software do provedor de rede e a status atual da rede.

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

Confira também

WNetGetNetworkInformation

Visão geral da Rede do Windows (WNet)

Estruturas de rede do Windows