Partager via

NPGetUniversalName, fonction (npapi.h)

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 au format de nom distant plus ancien.

Syntaxe

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

Paramètres

[in] lpLocalPath

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

[in] dwInfoLevel

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

Valeur Meaning
UNIVERSAL_NAME_INFO_LEVEL
 Récupère le formulaire UNC du nom, par exemple : « file :\\server\share »

Si cette valeur est définie, les données retournées dans lpBuffer sont stockées sous la forme d’une 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 sous forme de 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, car la mémoire tampon n’est pas suffisamment grande, cet emplacement est 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 éléments suivants.

Code de retour Descriptif
WN_BAD_LOCALNAME
 La valeur passée dans lpLocalPath n’est pas valide.
WN_NOT_CONNECTED
 La valeur passée dans 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.

Spécifications

Requirement Valeur
Client minimum requis Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Fenêtres
Header npapi.h
Library davclnt.lib
  • Last updated on