Funzione NetGetJoinInformation (lmjoin.h)

Articolo
08/24/2023

La funzione NetGetJoinInformation recupera le informazioni sullo stato di join per il computer specificato.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetGetJoinInformation(
  [in]  LPCWSTR               lpServer,
  [out] LPWSTR                *lpNameBuffer,
  [out] PNETSETUP_JOIN_STATUS BufferType
);

Parametri

[in] lpServer

Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del computer in cui chiamare la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.

[out] lpNameBuffer

Puntatore al buffer che riceve il nome NetBIOS del dominio o del gruppo di lavoro a cui viene aggiunto il computer. Questo buffer viene allocato dal sistema e deve essere liberato usando la funzione NetApiBufferFree . Per altre informazioni, vedere Buffer delle funzioni di gestione di rete e lunghezze del buffer delle funzioni di gestione di rete.

[out] BufferType

Riceve lo stato di join del computer specificato. Questo parametro può avere uno dei valori seguenti.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

Questi valori hanno i significati seguenti.

Valore	Significato
NetSetupUnknownStatus	Lo stato è sconosciuto.
NetSetupUnjoined	Il computer non è unito.
NetSetupWorkgroupName	Il computer viene aggiunto a un gruppo di lavoro.
NetSetupDomainName	Il computer viene aggiunto a un dominio.

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 il codice di errore seguente o uno dei codici di errore di sistema.

Codice restituito	Descrizione
ERROR_NOT_ENOUGH_MEMORY	Non è disponibile spazio di archiviazione sufficiente per elaborare questo comando.

Commenti

Per eseguire correttamente la funzione NetGetJoinInformation non è necessaria alcuna appartenenza a gruppi speciali.

Requisiti


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

Vedi anche

NetGetJoinableOUs

Funzioni di gestione di rete

Panoramica della gestione della rete

Condividi tramite