Função NetWkstaUserSetInfo (lmwksta.h)

Artigo
03/14/2023

A função NetWkstaUserSetInfo define as informações específicas do usuário sobre os elementos de configuração de uma estação de trabalho.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetWkstaUserSetInfo(
        LMSTR   reserved,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parâmetros

reserved

Esse parâmetro deve ser definido como zero.

[in] level

Especifica o nível de informações dos dados. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
1	Especifica informações sobre a estação de trabalho, incluindo o nome do usuário atual e os domínios acessados pela estação de trabalho. O parâmetro buf aponta para uma estrutura de WKSTA_USER_INFO_1 .
1101	Especifica domínios navegados pela estação de trabalho. O parâmetro buf aponta para uma estrutura de WKSTA_USER_INFO_1101 .

[in] buf

Ponteiro para o buffer que especifica os dados. O formato desses dados depende do valor do parâmetro de nível . Para obter mais informações, consulte Buffers de função de gerenciamento de rede.

[out] parm_err

Ponteiro para um valor que recebe o índice do primeiro parâmetro que causa o erro ERROR_INVALID_PARAMETER. Se esse parâmetro for NULL, o índice não será retornado por erro.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de erro.

Código de retorno	Descrição
ERROR_INVALID_LEVEL	O parâmetro de nível é inválido.
ERROR_INVALID_PARAMETER	Um dos parâmetros de função é inválido.

Comentários

A função NetWkstaUserSetInfo só funciona localmente. A associação ao grupo de administradores é necessária.

Os nomes de domínio no membro wkui1101_oth_domains da estrutura WKSTA_USER_INFO_1101 são separados por espaços. Uma lista vazia é válida. Um ponteiro NULL significa deixar o membro não modificado. O membro wkui1101_oth_domains não pode ser definido com MS-DOS. Ao definir esse elemento, NetWkstaUserSetInfo rejeitará a solicitação se a lista de nomes for inválida ou se um nome não puder ser adicionado a um ou mais adaptadores de rede gerenciados pelo sistema.

Se a função NetWkstaUserSetInfo retornar ERROR_INVALID_PARAMETER, você poderá usar o parâmetro parm_err para indicar o membro da estrutura de informações do usuário da estação de trabalho inválida. (Uma estrutura de informações do usuário da estação de trabalho começa com WKSTA_USER_INFO_ e seu formato é especificado pelo parâmetro de nível .) A tabela a seguir lista o valor que pode ser retornado no parâmetro parm_err e no membro da estrutura correspondente que está em erro. (O prefixo wkui*_ indica que o membro pode começar com vários prefixos, por exemplo, wkui0_ ou wkui1_.)

Valor	Membro
WKSTA_OTH_DOMAINS_PARMNUM	wkui*_oth_domains

Exemplos

O exemplo de código a seguir demonstra como definir informações específicas do usuário para uma estação de trabalho usando uma chamada para a função NetWkstaUserSetInfo , especificando o nível de informações 1101 ( WKSTA_USER_INFO_1101).

#ifndef UNICODE
#define UNICODE
#endif
#pragma comment(lib, "netapi32.lib")

#include <stdio.h>
#include <windows.h> 
#include <lm.h>

int wmain(int argc, wchar_t *argv[])
{
   DWORD dwLevel = 1101;
   WKSTA_USER_INFO_1101 wui;
   NET_API_STATUS nStatus;

   if (argc != 2)
   {
      fwprintf(stderr, L"Usage: %s OtherDomains\n", argv[0]);
      exit(1);
   }
   //
   // Fill in the WKSTA_USER_INFO_1101 structure member.
   //
   wui.wkui1101_oth_domains = argv[1];
   //
   // Call the NetWkstaUserSetInfo function
   //  to change the list of domains browsed by
   //  the workstation; specify level 1101.
   //
   nStatus = NetWkstaUserSetInfo(NULL,
                                 dwLevel,
                                 (LPBYTE)&wui,
                                 NULL);
   //
   // Display the result of the call.
   //
   if (nStatus == NERR_Success)
      fprintf(stderr, "Workstation user information has been changed\n");
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);

   return 0;
}

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]
Plataforma de Destino	Windows
Cabeçalho	lmwksta.h (inclua Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll