Fonction NPGetUniversalName (npapi.h)

Article
03/04/2024

Récupère le nom universel d’une ressource réseau. La fonction NPGetUniversalName peut récupérer ce nom universel au format UNC ou dans l’ancien format de nom distant.

Syntaxe

DWORD NPGetUniversalName(
  [in]      LPCWSTR lpLocalPath,
  [in]      DWORD   dwInfoLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Paramètres

[in] lpLocalPath

Pointeur vers le chemin local d’un objet sur une ressource réseau. Il s’agit d’un chemin basé sur un lecteur.

[in] dwInfoLevel

Niveau de détail des informations qui intéressent l’appelant. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
UNIVERSAL_NAME_INFO_LEVEL	Récupère la forme UNC du nom, par exemple : « file :\\server\share » Si cette valeur est définie, les données retournées dans lpBuffer sont stockées en tant que structure UNIVERSAL_NAME_INFO .
REMOTE_NAME_INFO_LEVEL	Récupère la forme distante du nom, par exemple : « \\server\share » Si cette valeur est définie, les données retournées dans lpBuffer sont stockées en tant que structure REMOTE_NAME_INFO .

[out] lpBuffer

Pointeur vers une mémoire tampon pour recevoir les informations demandées par l’utilisateur. La structure spécifique retournée dépend du niveau d’informations spécifié dans dwInfoLevel.

[in, out] lpBufferSize

Pointeur vers la taille, en octets, de la mémoire tampon lpBuffer . Si l’appel échoue parce que la mémoire tampon n’est pas assez grande, cet emplacement sera utilisé pour retourner la taille de mémoire tampon requise.

Valeur retournée

Si la fonction réussit, elle doit retourner WN_SUCCESS. Sinon, il doit retourner un code d’erreur, qui peut être l’un des suivants.

Code de retour	Description
WN_BAD_LOCALNAME	La valeur passée dans lpLocalPath n’est pas valide.
WN_NOT_CONNECTED	La valeur transmise à lpLocalPath n’est pas un appareil redirigé.
WN_MORE_DATA	La mémoire tampon est trop petite.
WN_NO_NETWORK	Le réseau n’est pas présent.

Configuration requise

Condition requise	Valeur
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	npapi.h

Share via