estrutura USE_INFO_1 (lmuse.h)

  • Artigo

A estrutura USE_INFO_1 contém informações sobre a conexão entre um dispositivo local e um recurso compartilhado. As informações incluem status de conexão e tipo de conexão.

Sintaxe

typedef struct _USE_INFO_1 {
  LMSTR ui1_local;
  LMSTR ui1_remote;
  LMSTR ui1_password;
  DWORD ui1_status;
  DWORD ui1_asg_type;
  DWORD ui1_refcount;
  DWORD ui1_usecount;
} USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;

Membros

ui1_local

Tipo: LMSTR

Um ponteiro para uma cadeia de caracteres que contém o nome do dispositivo local (por exemplo, unidade E ou LPT1) sendo redirecionado para o recurso compartilhado. A constante DEVLEN especifica o número máximo de caracteres na cadeia de caracteres. Esse membro pode ser NULL. Para obter mais informações, consulte a seção Comentários a seguir.

Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.

ui1_remote

Tipo: LMSTR

Um ponteiro para uma cadeia de caracteres que contém o nome do compartilhamento do recurso remoto que está sendo acessado. A cadeia de caracteres está no formato:

\\servername\sharename

Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.

ui1_password

Tipo: LMSTR

Um ponteiro para uma cadeia de caracteres que contém a senha necessária para estabelecer uma sessão entre uma estação de trabalho específica e um servidor.

Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.

ui1_status

Tipo: DWORD

O status da conexão. Esse elemento não é usado pela função NetUseAdd . Os valores a seguir são definidos.

Valor Significado
USE_OK
 A conexão é válida.
USE_PAUSED
 Pausado por estação de trabalho local.
USE_SESSLOST
 Desconectado
USE_DISCONN
 Ocorreu um erro.
USE_NETERR
 Ocorreu um erro de rede.
USE_CONN
 A conexão está sendo feita.
USE_RECONN
 Reconectar.

ui1_asg_type

Tipo: DWORD

O tipo de recurso remoto que está sendo acessado. Esse membro pode ser um dos valores a seguir.

Valor Significado
USE_WILDCARD
 Corresponde ao tipo de recursos compartilhados do servidor. Curingas só podem ser usados com a função NetUseAdd e somente quando o membro ui1_local é NULL. Para obter mais informações, consulte a seção Comentários a seguir.
USE_DISKDEV
 Dispositivo de disco.
USE_SPOOLDEV
 Impressora em spool.
USE_IPC
 Comunicação entre processos (IPC).

ui1_refcount

Tipo: DWORD

O número de arquivos, diretórios e outros processos abertos no recurso remoto. Esse elemento não é usado pela função NetUseAdd .

ui1_usecount

Tipo: DWORD

O número de conexões explícitas (redirecionamento com um nome de dispositivo local) ou conexões UNC implícitas (redirecionamento sem um nome de dispositivo local) estabelecidas com o recurso.

Comentários

Especificar um membro ui1_local que seja NULL solicita autenticação com o servidor sem redirecionar uma letra da unidade ou um dispositivo. Redirecionamentos futuros envolvendo o servidor enquanto a mesma conexão estiver em vigor usam a senha especificada pelo membro ui1_password na chamada inicial para a função NetUseAdd .

Requisitos

   
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 lmuse.h (inclua Lm.h)

Confira também

NetUseAdd

NetUseEnum

NetUseGetInfo

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Usar funções