NetWkstaUserSetInfo, fonction (lmwksta.h)

Article
08/24/2023

La fonction NetWkstaUserSetInfo définit les informations spécifiques à l’utilisateur sur les éléments de configuration d’une station de travail.

Syntaxe

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

Paramètres

reserved

Ce paramètre doit être défini sur zéro.

[in] level

Spécifie le niveau d’informations des données. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
1	Spécifie des informations sur la station de travail, notamment le nom de l’utilisateur actuel et les domaines auxquels la station de travail a accédé. Le paramètre buf pointe vers une structure WKSTA_USER_INFO_1 .
1101	Spécifie les domaines parcourus par la station de travail. Le paramètre buf pointe vers une structure WKSTA_USER_INFO_1101 .

[in] buf

Pointeur vers la mémoire tampon qui spécifie les données. Le format de ces données dépend de la valeur du paramètre de niveau . Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau.

[out] parm_err

Pointeur vers une valeur qui reçoit l’index du premier paramètre qui provoque l’erreur ERROR_INVALID_PARAMETER. Si ce paramètre a la valeur NULL, l’index n’est pas retourné en cas d’erreur.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_INVALID_LEVEL	Le paramètre de niveau n’est pas valide.
ERROR_INVALID_PARAMETER	L’un des paramètres de fonction n’est pas valide.

Notes

La fonction NetWkstaUserSetInfo fonctionne uniquement localement. L’appartenance au groupe d’administrateurs est requise.

Les noms de domaine du membre wkui1101_oth_domains de la structure WKSTA_USER_INFO_1101 sont séparés par des espaces. Une liste vide est valide. Un pointeur NULL signifie laisser le membre non modifié. Le membre wkui1101_oth_domains ne peut pas être défini avec MS-DOS. Lors de la définition de cet élément, NetWkstaUserSetInfo rejette la demande si la liste de noms n’était pas valide ou si un nom n’a pas pu être ajouté à une ou plusieurs cartes réseau gérées par le système.

Si la fonction NetWkstaUserSetInfo retourne ERROR_INVALID_PARAMETER, vous pouvez utiliser le paramètre parm_err pour indiquer le membre de la structure d’informations utilisateur de la station de travail qui n’est pas valide. (Une structure d’informations utilisateur de station de travail commence par WKSTA_USER_INFO_ et son format est spécifié par le paramètre level .) Le tableau suivant répertorie la valeur qui peut être retournée dans le paramètre parm_err et le membre de structure correspondant qui est en erreur. (Le préfixe wkui*_ indique que le membre peut commencer par plusieurs préfixes, par exemple, wkui0_ ou wkui1_.)

Valeur	Membre
WKSTA_OTH_DOMAINS_PARMNUM	wkui*_oth_domains

Exemples

L’exemple de code suivant montre comment définir des informations spécifiques à l’utilisateur pour une station de travail à l’aide d’un appel à la fonction NetWkstaUserSetInfo , en spécifiant le niveau d’informations 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;
}

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmwksta.h (inclure Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll