Funzione NetServerTransportAddEx (lmserver.h)

La funzione NetServerTransportAddEx associa il server specificato al protocollo di trasporto. Questa funzione estesa consente all'applicazione chiamante di specificare i livelli di informazioni SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 .

Sintassi

NET_API_STATUS NET_API_FUNCTION NetServerTransportAddEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

Parametri

[in] servername

Puntatore a una stringa che specifica il nome del server remoto in cui deve essere eseguita la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.

[in] level

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

Valore Significato
0
Specifica informazioni sul protocollo di trasporto, tra cui nome, indirizzo e posizione nella rete. Il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_0 .
1
Specifica informazioni sul protocollo di trasporto, inclusi nome, indirizzo, percorso di rete e dominio. Il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_1 .
2
Specifica le stesse informazioni del livello 1, con l'aggiunta di un membro svti2_flags . Il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_2 .
3
Specifica le stesse informazioni del livello 2, con l'aggiunta di informazioni sulle credenziali. Il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_3 .

[in] bufptr

Puntatore al buffer contenente i dati. Il formato di questi dati dipende dal valore del parametro level .

Per altre informazioni, vedere Buffer delle funzioni di gestione di rete.

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_ACCESS_DENIED
L'utente non ha accesso alle informazioni richieste.
ERROR_DUP_NAME
Nella rete esiste un nome duplicato.
ERROR_INVALID_DOMAINNAME
Impossibile trovare il nome di dominio nella rete.
ERROR_INVALID_LEVEL
Il valore specificato per il parametro level non è valido.
ERROR_INVALID_PARAMETER
Un parametro non è valido.

Questo errore viene restituito se il nome del trasporto o il membro dell'indirizzo di trasporto nel SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 struttura a cui punta il parametro bufptr è NULL. Questo errore viene restituito anche se il membro della lunghezza dell'indirizzo di trasporto nel SERVER_TRANSPORT_INFO_0, SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 struttura a cui punta il parametro bufptr è zero o maggiore di MAX_PATH (definito nel file di intestazione Windef.h ). Questo errore viene restituito anche se il membro flag del SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 struttura a cui punta il parametro bufptr contiene un valore non valido.

Questo errore viene restituito anche per altri parametri non validi.

ERROR_NOT_ENOUGH_MEMORY
Memoria insufficiente disponibile.

Commenti

Solo i membri del gruppo locale Administrators o Server Operators possono eseguire correttamente la funzione NetServerTransportAddEx .

Se si aggiunge un protocollo di trasporto a un server usando una chiamata alla funzione NetServerTransportAddEx , la connessione non rimarrà dopo il riavvio o il riavvio del server.

La funzione NetServerComputerNameAdd è una funzione di utilità. Combina le funzionalità della funzione NetServerTransportEnum e la funzione NetServerTransportAddEx , consentendo di specificare un nome server emulato.

In Windows Server 2008 e Windows Vista con Service Pack 1 (SP1), ogni nome registrato con il file server remoto di Windows (SRV) viene designato come nome con ambito o nome non con ambito. Ogni condivisione aggiunta al sistema verrà quindi collegata a tutti i nomi non con ambito o a un singolo nome con ambito. Le applicazioni che desiderano usare le funzionalità di ambito sono responsabili della registrazione del nuovo nome come endpoint con ambito e quindi della creazione delle condivisioni con un ambito appropriato. In questo modo, gli usi legacy delle funzioni Gestione rete e Gestione condivisione di rete non sono interessati in alcun modo perché continuano a registrare condivisioni e nomi come nomi non con ambito.

Un endpoint con ambito viene creato chiamando la funzione NetServerTransportAddEx con il parametro level impostato su 2 e il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_2 con il valore di bit SVTI2_SCOPED_NAME impostato in svti2_flags membro. Viene creato anche un endpoint con ambito chiamando la funzione NetServerTransportAddEx con il parametro level impostato su 3 e il parametro bufptr punta a una struttura SERVER_TRANSPORT_INFO_3 con il valore di bit SVTI2_SCOPED_NAME impostato nel membro svti3_flags .

Quando il valore di bit SVTI2_SCOPED_NAME è impostato per un trasporto, le condivisioni possono essere aggiunte con un nome del server corrispondente (il membro shi503_servername della struttura SHARE_INFO_503 ) in modo con ambito tramite la funzione NetShareAdd . Se non è presente alcun trasporto registrato con il valore di bit SVTI2_SCOPED_NAME e il nome specificato nel membro shi503_servername , l'aggiunta di condivisione in modo con ambito non avrà esito positivo.

La funzione NetShareAdd viene usata per aggiungere una condivisione con ambito in un server remoto specificato nel parametro servername . Il server remoto specificato nel membro shi503_servername del SHARE_INFO_503 passato nel parametro bufptr deve essere stato associato a un protocollo di trasporto usando la funzione NetServerTransportAddEx come endpoint con ambito. Il flag SVTI2_SCOPED_NAME deve essere stato specificato nel membro shi503_servername della struttura SERVER_TRANSPORT_INFO_2 o SERVER_TRANSPORT_INFO_3 per il protocollo di trasporto. La funzione NetShareDelEx viene usata per eliminare una condivisione con ambito. Le funzioni NetShareGetInfo e NetShareSetInfo consentono di ottenere e impostare informazioni su una condivisione con ambito.

Gli endpoint con ambito vengono in genere usati dallo spazio dei nomi del cluster.

Requisiti

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

Vedi anche

NetServerComputerNameAggiungi

NetServerComputerNameDel

NetServerTransportAdd

NetServerTransportDel

NetServerTransportEnum

NetShareAdd

NetShareDelEx

NetShareGetInfo

NetShareSetInfo

Funzioni di gestione di rete

Panoramica della gestione della rete

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_2

SERVER_TRANSPORT_INFO_3

SHARE_INFO_503

Funzioni di trasporto server e workstation