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