NetServerSetInfo, fonction (lmserver.h)

La fonction NetServerSetInfo définit les paramètres de fonctionnement d’un serveur ; il peut les définir individuellement ou collectivement. Les informations sont stockées d’une manière qui leur permet de rester en vigueur une fois que le système a été réinitialisé.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetServerSetInfo(
  [in]  LMSTR   servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD ParmError
);

Paramètres

[in] servername

Pointeur vers une chaîne qui spécifie le nom du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] level

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

En outre, les niveaux 1001-1006, 1009-1011, 1016-1018, 1021, 1022, 1028, 1029, 1037 et 1043 sont valides en fonction des restrictions pour les systèmes LAN Manager.

[in] buf

Pointeur vers une mémoire tampon qui reçoit les informations du serveur. 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] ParmError

Pointeur vers une valeur qui reçoit l’index du premier membre de la structure d’informations du serveur 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. Pour plus d'informations, consultez la section Notes qui suit.

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

Seuls les membres du groupe local Administrateurs ou Opérateurs de serveur peuvent exécuter correctement la fonction NetServerSetInfo .

Si vous programmez pour Active Directory, vous pouvez peut-être appeler certaines méthodes ADSI (Active Directory Service Interface) pour obtenir les mêmes fonctionnalités que celles que vous pouvez obtenir en appelant les fonctions du serveur d’administration réseau. Pour plus d’informations, consultez IADsComputer.

Si la fonction NetServerSetInfo retourne ERROR_INVALID_PARAMETER, vous pouvez utiliser le paramètre ParmError pour indiquer le premier membre de la structure d’informations du serveur qui n’est pas valide. (Une structure d’informations de serveur commence par SERVER_INFO_ et son format est spécifié par le paramètre level .) Le tableau suivant répertorie les valeurs qui peuvent être retournées dans le paramètre ParmError et le membre de structure correspondant qui est en erreur. (Le préfixe sv*_ indique que le membre peut commencer par plusieurs préfixes, par exemple, sv101_ ou sv402_.)

Exemples

L’exemple de code suivant montre comment appeler la fonction NetServerSetInfo . L’exemple appelle NetServerSetInfo, en spécifiant le paramètre de niveau 1005 (obligatoire) pour définir le sv1005_comment membre de la structure SERVER_INFO_1005 .

#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 = 1005;
   SERVER_INFO_1005 si;
   NET_API_STATUS nStatus;

   if (argc != 3)
   {
      fwprintf(stderr, L"Usage: %s \\\\ServerName Comment\n", argv[0]);
      exit(1);
   }
   //
   // Fill in SERVER_INFO_1005 structure member.
   //
   si.sv1005_comment = (LPTSTR) argv[2];
   //
   // Call the NetServerSetInfo function, 
   //  specifying level 1005.
   //
   nStatus = NetServerSetInfo(argv[1],
                              dwLevel,
                              (LPBYTE)&si,
                              NULL);
   //
   // Display the result of the call.
   //
   if (nStatus == NERR_Success)
      fwprintf(stderr, L"Comment reset\n", argv[2]);
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);
   return 0;
}

Spécifications

Voir aussi

NetServerGetInfo

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

SERVER_INFO_101

SERVER_INFO_102

SERVER_INFO_402

SERVER_INFO_403

Fonctions serveur