Partager via


Fonction NetFileGetInfo (lmshare.h)

Récupère des informations sur une ouverture particulière d’une ressource serveur.

Syntaxe

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

Paramètres

[in] servername

Pointeur vers une chaîne qui spécifie le nom DNS ou NetBIOS du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

Cette chaîne est Unicode si _WIN32_WINNT ou FORCE_UNICODE est défini.

[in] fileid

Spécifie l’identificateur de fichier de la ressource ouverte pour laquelle retourner des informations. La valeur de ce paramètre doit avoir été retournée dans un appel d’énumération précédent. Pour plus d'informations, consultez la section Notes qui suit.

[in] level

Spécifie le niveau d’informations des données. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
2
Retourne le numéro d’identification du fichier. Le paramètre bufptr est un pointeur vers une structure FILE_INFO_2 .
3
Retourne le numéro d’identification du fichier et d’autres informations sur le fichier. Le paramètre bufptr est un pointeur vers une structure FILE_INFO_3 .

[out] bufptr

Pointeur vers l’adresse de la mémoire tampon qui reçoit les informations. Le format de ces données dépend de la valeur du paramètre de niveau . Cette mémoire tampon est allouée par le système et doit être libérée à l’aide de la fonction NetApiBufferFree . Pour plus d’informations, consultez Mémoires tampons de fonction de gestionréseau et Longueurs de mémoire tampon des fonctions de gestion réseau.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Code de retour Description
ERROR_ACCESS_DENIED
L’utilisateur n’a pas accès aux informations demandées.
ERROR_FILE_NOT_FOUND
Ce fichier est introuvable.
ERROR_INVALID_LEVEL
La valeur spécifiée pour le paramètre de niveau n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY
La mémoire disponible est insuffisante.
NERR_BufTooSmall
La mémoire tampon fournie est trop petite.

Notes

Seuls les membres du groupe local Administrateurs ou Opérateurs de serveur peuvent exécuter correctement la fonction NetFileGetInfo .

Vous pouvez appeler la fonction NetFileEnum pour récupérer des informations sur plusieurs fichiers ouverts sur un serveur.

Si vous programmez pour Active Directory, vous pouvez peut-être appeler certaines méthodes ADSI (Active Directory Service Interface) pour obtenir les mêmes fonctionnalités que celles que vous pouvez obtenir en appelant NetFileGetInfo. Pour plus d’informations, consultez IADsResource et IADsFileServiceOperations.

Spécifications

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête lmshare.h (inclure Lm.h)
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

FILE_INFO_2

FILE_INFO_3

Fonctions NetFile

NetFileEnum

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau