Compartilhar via


estrutura USER_INFO_11 (lmaccess.h)

A estrutura USER_INFO_11 contém informações sobre uma conta de usuário, incluindo o nome da conta, o nível de privilégio, o caminho para o diretório inicial do usuário e outras estatísticas de rede relacionadas ao usuário.

Sintaxe

typedef struct _USER_INFO_11 {
  LPWSTR usri11_name;
  LPWSTR usri11_comment;
  LPWSTR usri11_usr_comment;
  LPWSTR usri11_full_name;
  DWORD  usri11_priv;
  DWORD  usri11_auth_flags;
  DWORD  usri11_password_age;
  LPWSTR usri11_home_dir;
  LPWSTR usri11_parms;
  DWORD  usri11_last_logon;
  DWORD  usri11_last_logoff;
  DWORD  usri11_bad_pw_count;
  DWORD  usri11_num_logons;
  LPWSTR usri11_logon_server;
  DWORD  usri11_country_code;
  LPWSTR usri11_workstations;
  DWORD  usri11_max_storage;
  DWORD  usri11_units_per_week;
  PBYTE  usri11_logon_hours;
  DWORD  usri11_code_page;
} USER_INFO_11, *PUSER_INFO_11, *LPUSER_INFO_11;

Membros

usri11_name

Tipo: LPWSTR

Um ponteiro para um caractere Unicode que especifica o nome da conta de usuário. As chamadas para a função NetUserSetInfo ignoram esse membro. Para obter mais informações, consulte a seção Comentários a seguir.

usri11_comment

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode que contém um comentário associado à conta de usuário. Essa cadeia de caracteres pode ser uma cadeia de caracteres NULL ou pode ter qualquer número de caracteres antes do caractere nulo de terminação.

usri11_usr_comment

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode que contém um comentário do usuário. Essa cadeia de caracteres pode ser uma cadeia de caracteres NULL ou pode ter qualquer número de caracteres antes do caractere nulo de terminação.

usri11_full_name

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode que contém o nome completo do usuário. Essa cadeia de caracteres pode ser uma cadeia de caracteres NULL ou pode ter qualquer número de caracteres antes do caractere nulo de terminação.

usri11_priv

Tipo: DWORD

O nível de privilégio atribuído ao membro usri11_name . Para chamadas para a função NetUserAdd , esse membro deve ser USER_PRIV_USER. Para chamadas para NetUserSetInfo, esse membro deve ser o valor retornado da função NetUserGetInfo ou da função NetUserEnum . Esse membro pode ser um dos valores a seguir. Para obter mais informações sobre direitos de conta de usuário e grupo, consulte Privilégios.

Valor Significado
USER_PRIV_GUEST
Convidado
USER_PRIV_USER
Usuário
USER_PRIV_ADMIN
Administrador

usri11_auth_flags

Tipo: DWORD

Um conjunto de sinalizadores de bits que definem os privilégios de operador do usuário.

As chamadas para a função NetUserGetInfo e a função NetUserEnum retornam um valor com base na associação de grupo local do usuário. Se o usuário for membro dos Operadores de Impressão, AF_OP_PRINT será definido. Se o usuário for membro dos Operadores de Servidor, AF_OP_SERVER será definido. Se o usuário for membro dos Operadores de Conta, AF_OP_ACCOUNTS será definido. AF_OP_COMM nunca está definido.

As funções NetUserAdd e NetUserSetInfo ignoram esse membro.

As restrições a seguir se aplicam:

Esse membro pode ser um ou mais dos valores a seguir.
Valor Significado
AF_OP_PRINT
O privilégio do operador de impressão está habilitado.
AF_OP_COMM
O privilégio do operador de comunicações está habilitado.
AF_OP_SERVER
O privilégio do operador de servidor está habilitado.
AF_OP_ACCOUNTS
O privilégio do operador de contas está habilitado.

usri11_password_age

Tipo: DWORD

O número de segundos decorridos desde que o membro usri11_password foi alterado pela última vez. As funções NetUserAdd e NetUserSetInfo ignoram esse membro.

usri11_home_dir

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode que especifica o caminho do diretório base para o usuário especificado no membro usri11_name . A cadeia de caracteres pode ser NULL.

usri11_parms

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode reservada para uso por aplicativos. Essa cadeia de caracteres pode ser uma cadeia de caracteres NULL ou pode ter qualquer número de caracteres antes do caractere nulo de terminação. Os produtos da Microsoft usam esse membro para armazenar informações de configuração do usuário. Não modifique essas informações.

usri11_last_logon

Tipo: DWORD

A data e a hora em que o último logon ocorreu. Esse valor é armazenado como o número de segundos decorridos desde 00:00:00, 1º de janeiro de 1970, GMT. As funções NetUserAdd e NetUserSetInfo ignoram esse membro.

Esse membro é mantido separadamente em cada BDC (controlador de domínio de backup) no domínio. Para obter um valor preciso, você deve consultar cada BDC no domínio. O último logon ocorreu no momento indicado pelo maior valor recuperado.

usri11_last_logoff

Tipo: DWORD

No momento, esse membro não é usado.

A data e a hora em que o último logoff ocorreu. Esse valor é armazenado como o número de segundos decorridos desde 00:00:00, 1º de janeiro de 1970, GMT. Um valor zero indica que a hora do último logoff é desconhecida. A função NetUserAdd e a função NetUserSetInfo ignoram esse membro.

Esse membro é mantido separadamente em cada BDC (controlador de domínio de backup) no domínio. Para obter um valor preciso, você deve consultar cada BDC no domínio. O último logoff ocorreu no momento indicado pelo maior valor recuperado.

usri11_bad_pw_count

Tipo: DWORD

O número de vezes que o usuário tentou fazer logon nessa conta usando uma senha incorreta. Um valor de – 1 indica que o valor é desconhecido. As funções NetUserAdd e NetUserSetInfo ignoram esse membro.

Esse membro é replicado do controlador de domínio primário (PDC); ele também é mantido em cada BDC (controlador de domínio de backup) no domínio. Para obter um valor preciso, você deve consultar cada BDC no domínio. O número de vezes que o usuário tentou fazer logon usando uma senha incorreta é o maior valor recuperado.

usri11_num_logons

Tipo: DWORD

O número de vezes que o usuário fez logon com êxito nessa conta. Um valor de – 1 indica que o valor é desconhecido. As chamadas para as funções NetUserAdd e NetUserSetInfo ignoram esse membro.

Esse membro é mantido separadamente em cada BDC (controlador de domínio de backup) no domínio. Para obter um valor preciso, você deve consultar cada BDC no domínio. O número de vezes que o usuário fez logon com êxito é a soma dos valores recuperados.

usri11_logon_server

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do servidor para o qual as solicitações de logon são enviadas. Os nomes do servidor devem ser precedidos por duas barras invertidas (\). Para indicar que a solicitação de logon pode ser manipulada por qualquer servidor de logon, especifique um asterisco (\*) para o nome do servidor. Uma cadeia de caracteres NULL indica que as solicitações devem ser enviadas para o controlador de domínio.

Para servidores Windows, NetUserGetInfo e NetUserEnum retornam \*. As funções NetUserAdd e NetUserSetInfo ignoram esse membro.

usri11_country_code

Tipo: DWORD

O código de país/região para a linguagem de escolha do usuário.

usri11_workstations

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode que contém os nomes das estações de trabalho das quais o usuário pode fazer logon. Até oito estações de trabalho podem ser especificadas; os nomes devem ser separados por vírgulas. Uma cadeia de caracteres NULL indica que não há restrição. Para desabilitar logons de todas as estações de trabalho para essa conta, defina o valor UF_ACCOUNTDISABLE no membro usri11_flags .

usri11_max_storage

Tipo: DWORD

A quantidade máxima de espaço em disco que o usuário pode usar. Especifique USER_MAXSTORAGE_UNLIMITED para usar todo o espaço em disco disponível.

usri11_units_per_week

Tipo: DWORD

O número de unidades de tempo de comprimento igual em que a semana é dividida. Esse valor é necessário para calcular o comprimento da cadeia de caracteres de bits no membro usri11_logon_hours .

Esse membro deve ser UNITS_PER_WEEK para o LAN Manager 2.0. Esse elemento é ignorado pelas funções NetUserAdd e NetUserSetInfo .

Para aplicativos de serviço, as unidades devem ser um dos seguintes valores: SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK ou SAM_MINUTES_PER_WEEK.

usri11_logon_hours

Tipo: PBYTE

Um ponteiro para uma cadeia de caracteres de bits de 21 bytes (168 bits) que especifica os horários durante os quais o usuário pode fazer logon. Cada bit representa uma hora exclusiva na semana, em Greenwich Mean Time (GMT).

O primeiro bit (bit 0, palavra 0) é domingo, das 0h às 0h59; o segundo bit (bit 1, palavra 0) é domingo, 1:00 a 1:59; e assim por diante. Observe que o bit 0 na palavra 0 representa domingo das 0:00 às 0:59 somente se você estiver no fuso horário GMT. Em todos os outros casos, você deve ajustar os bits de acordo com o deslocamento de fuso horário (por exemplo, GMT menos 8 horas para o Horário Padrão do Pacífico).

Especifique um ponteiro NULL neste membro ao chamar a função NetUserAdd para indicar nenhuma restrição de tempo. Especifique um ponteiro NULL ao chamar a função NetUserSetInfo para indicar que nenhuma alteração deve ser feita nos horários durante os quais o usuário pode fazer logon.

usri11_code_page

Tipo: DWORD

A página de código para o idioma de escolha do usuário.

Comentários

Os nomes de conta de usuário são limitados a 20 caracteres e os nomes de grupo são limitados a 256 caracteres. Além disso, os nomes de conta não podem ser encerrados por um período e não podem incluir vírgulas ou qualquer um dos seguintes caracteres imprimíveis: ", /, , [, ], :, |, <, , >, +, =, ;, ?, *. Os nomes também não podem incluir caracteres no intervalo de 1 a 31, que são não imprimíveis.

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

Confira também

NetUserAdd

NetUserDel

NetUserEnum

NetUserGetInfo

NetUserSetInfo

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Funções de usuário