Funzione NetWkstaTransportAdd (lmwksta.h)

Articolo
03/14/2023

[Questa funzione è obsoleta. Per modificare manualmente le impostazioni predefinite per i protocolli di trasporto, utilizzare la finestra di dialogo Proprietà connessione area locale nella cartella Connessioni di rete e connessione remota.]

Non supportato.

La funzione NetWkstaTransportAdd associa (o connette) il redirector al trasporto. Il redirector è il software nel computer client che genera richieste di file al computer server.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parametri

[in] servername

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

Questa stringa deve iniziare con \.

[in] level

Specifica il livello di informazioni dei dati. Questo parametro può essere il valore seguente.

Valore	Significato
0	Specifica le informazioni sul protocollo di trasporto della workstation. Il parametro buf punta a una struttura WKSTA_TRANSPORT_INFO_0 .

[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_ACCESS_DENIED	L'utente non ha accesso alle informazioni richieste.
ERROR_INVALID_LEVEL	Il parametro level, che indica il livello di informazioni sulla struttura dei dati disponibile, non è valido.
ERROR_INVALID_PARAMETER	Uno dei parametri della funzione non è valido.

Commenti

Solo i membri del gruppo locale Administrators possono eseguire correttamente la funzione NetWkstaTransportAdd .

Se la funzione NetWkstaTransportAdd restituisce ERROR_INVALID_PARAMETER, è possibile usare il parametro parm_err per indicare il membro della struttura WKSTA_TRANSPORT_INFO_0 non valida. Nella tabella seguente sono elencati i valori che possono essere restituiti nel parametro parm_err e nel membro della struttura corrispondente in errore.

Valore	Membro
TRANSPORT_QUALITYOFSERVICE_PARMNUM	wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM	wkti0_transport_name

Requisiti


Piattaforma di destinazione	Windows
Intestazione	lmwksta.h (include Lm.h, Lmwksta.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll

Condividi tramite