Función NPGetUniversalName (npapi.h)

  • Artículo

Recupera el nombre universal de un recurso de red. La función NPGetUniversalName puede recuperar este nombre universal en formato UNC o en el formato de nombre remoto anterior.

Sintaxis

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

Parámetros

[in] lpLocalPath

Puntero a la ruta de acceso local de un objeto en un recurso de red. Se trata de una ruta de acceso basada en unidades.

[in] dwInfoLevel

El nivel de detalle de la información en la que está interesado el autor de la llamada. Puede ser uno de los valores siguientes.

Valor Significado
UNIVERSAL_NAME_INFO_LEVEL
 Recupera el formato UNC del nombre, por ejemplo: "file:\\server\share"

Si se establece este valor, los datos devueltos en lpBuffer se almacenan como una estructura UNIVERSAL_NAME_INFO .
REMOTE_NAME_INFO_LEVEL
 Recupera la forma remota del nombre, por ejemplo: "\\server\share"

Si se establece este valor, los datos devueltos en lpBuffer se almacenan como una estructura REMOTE_NAME_INFO .

[out] lpBuffer

Puntero a un búfer para recibir la información que el usuario ha solicitado. La estructura específica devuelta depende del nivel de información especificado en dwInfoLevel.

[in, out] lpBufferSize

Puntero al tamaño, en bytes, del búfer lpBuffer . Si se produce un error en la llamada porque el búfer no es lo suficientemente grande, esta ubicación se usará para devolver el tamaño de búfer necesario.

Valor devuelto

Si la función se ejecuta correctamente, debe devolver WN_SUCCESS. De lo contrario, debe devolver un código de error, que puede ser uno de los siguientes.

Código devuelto Descripción
WN_BAD_LOCALNAME
 El valor pasado a lpLocalPath no es válido.
WN_NOT_CONNECTED
 El valor pasado a lpLocalPath no es un dispositivo redirigido.
WN_MORE_DATA
 El búfer es demasiado pequeño.
WN_NO_NETWORK
 La red no está presente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado npapi.h