Función NetWkstaUserSetInfo (lmwksta.h)

Artículo
08/24/2023

La función NetWkstaUserSetInfo establece la información específica del usuario sobre los elementos de configuración de una estación de trabajo.

Sintaxis

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

Parámetros

reserved

Este parámetro debe establecerse en cero.

[in] level

Especifica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
1	Especifica información sobre la estación de trabajo, incluido el nombre del usuario actual y los dominios a los que accede la estación de trabajo. El parámetro buf apunta a una estructura de WKSTA_USER_INFO_1 .
1101	Especifica los dominios explorados por la estación de trabajo. El parámetro buf apunta a una estructura WKSTA_USER_INFO_1101 .

[in] buf

Puntero al búfer que especifica los datos. El formato de estos datos depende del valor del parámetro level . Para obtener más información, consulte Búferes de funciones de administración de red.

[out] parm_err

Puntero a un valor que recibe el índice del primer parámetro que provoca el error ERROR_INVALID_PARAMETER. Si este parámetro es NULL, el índice no se devuelve en caso de error.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_INVALID_LEVEL	El parámetro level no es válido.
ERROR_INVALID_PARAMETER	Uno de los parámetros de función no es válido.

Comentarios

La función NetWkstaUserSetInfo solo funciona localmente. Se requiere la pertenencia a grupos de administradores.

Los nombres de dominio del miembro wkui1101_oth_domains de la estructura WKSTA_USER_INFO_1101 están separados por espacios. Una lista vacía es válida. Un puntero NULL significa dejar el miembro sin modificar. El miembro wkui1101_oth_domains no se puede establecer con MS-DOS. Al establecer este elemento, NetWkstaUserSetInfo rechaza la solicitud si la lista de nombres no era válida o si no se pudo agregar un nombre a uno o varios de los adaptadores de red administrados por el sistema.

Si la función NetWkstaUserSetInfo devuelve ERROR_INVALID_PARAMETER, puede usar el parámetro parm_err para indicar el miembro de la estructura de información de usuario de la estación de trabajo que no es válida. (Una estructura de información de usuario de estación de trabajo comienza por WKSTA_USER_INFO_ y su formato se especifica mediante el parámetro level ). En la tabla siguiente se muestra el valor que se puede devolver en el parámetro parm_err y el miembro de estructura correspondiente que se encuentra en error. (El prefijo wkui*_ indica que el miembro puede comenzar con varios prefijos, por ejemplo, wkui0_ o wkui1_).

Valor	Miembro
WKSTA_OTH_DOMAINS_PARMNUM	wkui*_oth_domains

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer información específica del usuario para una estación de trabajo mediante una llamada a la función NetWkstaUserSetInfo , especificando el nivel de información 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 compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmwksta.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll