estrutura USE_INFO_2 (lmuse.h)
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.
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 |
|---|---|
|
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. |
|
Dispositivo de disco. |
|
Impressora com spool. |
|
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) |
Confira também
Visão geral do gerenciamento de rede