NetWkstaUserSetInfo, fonction (lmwksta.h)

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.

[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.

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_.)

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

Voir aussi

NetWkstaUserGetInfo

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

WKSTA_USER_INFO_1

WKSTA_USER_INFO_1101

Fonctions utilisateur de station de travail et de station de travail