Funzione NetWkstaUserSetInfo (lmwksta.h)

Articolo
03/14/2023

La funzione NetWkstaUserSetInfo imposta le informazioni specifiche dell'utente sugli elementi di configurazione per una workstation.

Sintassi

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

Parametri

reserved

Questo parametro deve essere impostato su zero.

[in] level

Specifica il livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
1	Specifica informazioni sulla workstation, inclusi il nome dell'utente corrente e i domini a cui si accede dalla workstation. Il parametro buf punta a una struttura WKSTA_USER_INFO_1 .
1101	Specifica i domini esplorati dalla workstation. Il parametro buf punta a una struttura WKSTA_USER_INFO_1101 .

[in] buf

Puntatore al buffer che specifica i dati. Il formato di questi dati dipende dal valore del parametro level . Per altre informazioni, vedere Buffer delle funzioni di gestione di rete.

[out] parm_err

Puntatore a un valore che riceve l'indice del primo parametro che causa l'errore ERROR_INVALID_PARAMETER. Se questo parametro è NULL, l'indice non viene restituito in caso di errore.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NERR_Success.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_INVALID_LEVEL	Il parametro di livello non è valido.
ERROR_INVALID_PARAMETER	Uno dei parametri della funzione non è valido.

Commenti

La funzione NetWkstaUserSetInfo funziona solo in locale. È necessaria l'appartenenza al gruppo amministratore.

I nomi di dominio nel membro wkui1101_oth_domains della struttura WKSTA_USER_INFO_1101 sono separati da spazi. Un elenco vuoto è valido. Un puntatore NULL significa lasciare invariato il membro. Impossibile impostare il membro wkui1101_oth_domains con MS-DOS. Quando si imposta questo elemento, NetWkstaUserSetInfo rifiuta la richiesta se l'elenco dei nomi non è valido o se non è stato possibile aggiungere un nome a una o più schede di rete gestite dal sistema.

Se la funzione NetWkstaUserSetInfo restituisce ERROR_INVALID_PARAMETER, è possibile usare il parametro parm_err per indicare il membro della struttura delle informazioni utente della workstation non valida. Una struttura delle informazioni utente della workstation inizia con WKSTA_USER_INFO_ e il relativo formato viene specificato dal parametro level . La tabella seguente elenca il valore che può essere restituito nel parametro parm_err e nel membro della struttura corrispondente in errore. Il prefisso wkui*_ indica che il membro può iniziare con più prefissi, ad esempio wkui0_ o wkui1_.

Valore	Membro
WKSTA_OTH_DOMAINS_PARMNUM	wkui*_oth_domains

Esempio

Nell'esempio di codice seguente viene illustrato come impostare informazioni specifiche dell'utente per una workstation usando una chiamata alla funzione NetWkstaUserSetInfo , specificando il livello di informazioni 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;
}

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmwksta.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll