Compartir a través de

Función NPGetUniversalName (npapi.h)

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.

Syntax

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 que le interesa al autor de la llamada. Puede ser uno de los siguientes valores.

Importancia Meaning
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 de 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 de 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 de retorno Description
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

Requirement Importancia
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header npapi.h
Library davclnt.lib
  • Last updated on