Funzione NetFileGetInfo (lmshare.h)

Articolo
08/24/2023

Recupera informazioni su una particolare apertura di una risorsa server.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetFileGetInfo(
  [in]  LMSTR  servername,
  [in]  DWORD  fileid,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

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 è Unicode se è definito _WIN32_WINNT o FORCE_UNICODE .

[in] fileid

Specifica l'identificatore di file della risorsa aperta per cui restituire informazioni. Il valore di questo parametro deve essere stato restituito in una chiamata di enumerazione precedente. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] level

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

Valore	Significato
2	Restituisce il numero di identificazione del file. Il parametro bufptr è un puntatore a una struttura FILE_INFO_2 .
3	Restituisce il numero di identificazione del file e altre informazioni sul file. Il parametro bufptr è un puntatore a una struttura FILE_INFO_3 .

[out] bufptr

Puntatore all'indirizzo del buffer che riceve le informazioni. Il formato di questi dati dipende dal valore del parametro level . 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.

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_FILE_NOT_FOUND	Impossibile trovare il file.
ERROR_INVALID_LEVEL	Il valore specificato per il parametro level non è valido.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente disponibile.
NERR_BufTooSmall	Il buffer fornito è troppo piccolo.

Commenti

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

È possibile chiamare la funzione NetFileEnum per recuperare informazioni su più file aperti in un server.

Se si esegue la programmazione per Active Directory, è possibile chiamare determinati metodi ADSI (Active Directory Service Interface) per ottenere la stessa funzionalità che è possibile ottenere chiamando NetFileGetInfo. Per altre informazioni, vedere IADsResource e IADsFileServiceOperations.

Requisiti


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