estrutura USE_INFO_1 (lmuse.h)

Artigo
08/24/2023

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)