estrutura USE_INFO_2 (lmuse.h)

Artigo
08/24/2023

A estrutura USE_INFO_2 contém informações sobre uma conexão entre um computador local e um recurso compartilhado, incluindo tipo de conexão, status de conexão, nome de usuário e nome de domínio.

Sintaxe

typedef struct _USE_INFO_2 {
  LMSTR ui2_local;
  LMSTR ui2_remote;
  LMSTR ui2_password;
  DWORD ui2_status;
  DWORD ui2_asg_type;
  DWORD ui2_refcount;
  DWORD ui2_usecount;
  LMSTR ui2_username;
  LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;

Membros

ui2_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. O DEVLEN constante 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 forem definidos.

ui2_remote

Tipo: LMSTR

Um ponteiro para uma cadeia de caracteres que contém o nome do compartilhamento do recurso remoto. A cadeia de caracteres está no formulário

\\servername\sharename

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

ui2_password

Tipo: LMSTR

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

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

ui2_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 foi bem-sucedida.
USE_PAUSED	Pausado por uma 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.

ui2_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 ui2_local é uma cadeia de caracteres NULL . Para obter mais informações, consulte a seção Comentários a seguir.
USE_DISKDEV	Dispositivo de disco.
USE_SPOOLDEV	Impressora com spool.
USE_IPC	Comunicação entre processos (IPC).

ui2_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 .

ui2_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.

ui2_username

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres que contém o nome do usuário que iniciou a conexão.

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

ui2_domainname

Tipo: LMSTR

Um ponteiro para uma cadeia de caracteres que contém o nome de domínio do recurso remoto.

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

Comentários

Especificar um membro de ui2_local que seja a autenticação de solicitações NULL com o servidor sem redirecionar uma letra de unidade ou um dispositivo. Redirecionamentos futuros envolvendo o servidor enquanto a mesma conexão estiver em vigor usam as informações de autenticação especificadas na chamada inicial para a função NetUseAdd . Essas informações incluem a combinação dos membros ui2_password, ui2_username e ui2_domainname .

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