Funzione NetWkstaTransportEnum (lmwksta.h)

Articolo
02/28/2024

La funzione NetWkstaTransportEnum fornisce informazioni sui protocolli di trasporto gestiti dal reindirizzamento, ovvero il software nel computer client che genera richieste di file al computer server.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportEnum(
  [in]      LPTSTR  servername,
  [in]      DWORD   level,
  [out]     LPBYTE  *bufptr,
  [in]      DWORD   prefmaxlen,
  [out]     LPDWORD entriesread,
  [out]     LPDWORD totalentries,
  [in, out] LPDWORD resume_handle
);

Parametri

[in] servername

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

[in] level

Livello di informazioni richieste per i dati. Questo parametro può essere il valore seguente.

Valore	Significato
0	Restituire le informazioni sul protocollo di trasporto della workstation. Il parametro bufptr punta a una matrice di strutture WKSTA_TRANSPORT_INFO_0 .

[out] bufptr

Puntatore al buffer che riceve i dati. Il formato di questi dati dipende dal valore del parametro di livello . Questo buffer viene allocato dal sistema e deve essere liberato usando la funzione NetApiBufferFree . Si noti che è necessario liberare il buffer anche se la funzione ha esito negativo con ERROR_MORE_DATA o NERR_BufTooSmall.

[in] prefmaxlen

Lunghezza massima preferita dei dati restituiti, in byte. Se si specifica MAX_PREFERRED_LENGTH, la funzione alloca la quantità di memoria necessaria per i dati. Se si specifica un altro valore in questo parametro, può limitare il numero di byte restituiti dalla funzione. Se le dimensioni del buffer non sono sufficienti per contenere tutte le voci, la funzione restituisce ERROR_MORE_DATA o NERR_BufTooSmall. Per altre informazioni, vedere Buffer delle funzioni di gestione della rete e lunghezze del buffer delle funzioni di gestione della rete.

[out] entriesread

Puntatore a un valore che riceve il conteggio degli elementi effettivamente enumerati.

[out] totalentries

Puntatore a un valore che riceve il numero totale di voci che potrebbero essere state enumerate dalla posizione di ripresa corrente. Si noti che le applicazioni devono considerare questo valore solo come hint.

[in, out] resume_handle

Puntatore a un valore che contiene un handle di ripresa usato per continuare una ricerca del trasporto della workstation esistente. L'handle deve essere zero nella prima chiamata e lasciato invariato per le chiamate successive. Se il parametro resumehandle è un puntatore NULL , non viene archiviato alcun handle di ripresa.

Valore restituito

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

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

Codice restituito	Descrizione
ERROR_MORE_DATA	Sono disponibili altre voci. Specificare un buffer sufficiente per ricevere tutte le voci.
ERROR_INVALID_LEVEL	Il parametro di livello, che indica il livello di informazioni sulla struttura dei dati disponibile, non è valido. Questo errore viene restituito se il parametro di livello viene specificato come valore diverso da zero.
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi. Questo errore viene restituito se i parametri bufptr o vociread sono puntatori NULL .
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente disponibile per elaborare la richiesta.
ERROR_NOT_SUPPORTED	La richiesta non è supportata. Questo errore viene restituito se un server remoto è stato specificato nel parametro nome server e questa richiesta non è supportata nel server remoto.
NERR_BufTooSmall	Sono disponibili altre voci. Specificare un buffer sufficiente per ricevere tutte le voci. Questo codice di errore viene definito nel file di intestazione Lmerr.h .

Commenti

Non è necessaria alcuna appartenenza a gruppi speciali per eseguire correttamente la funzione NetWkstaTransportEnum .

Requisiti

Requisito	Valore
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