Функция NPGetUniversalName (npapi.h)

  • Статья

Извлекает универсальное имя сетевого ресурса. Функция NPGetUniversalName может получить это универсальное имя в формате UNC или в более старом формате удаленного имени.

Синтаксис

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

Параметры

[in] lpLocalPath

Указатель на локальный путь к объекту в сетевом ресурсе. Это путь на основе диска.

[in] dwInfoLevel

Уровень детализации информации, интересующей вызывающий объект. Это может быть одно из следующих значений.

Значение Значение
UNIVERSAL_NAME_INFO_LEVEL
 Извлекает UNC-форму имени, например "file:\\server\share".

Если это значение задано, данные, возвращаемые в lpBuffer , сохраняются в виде UNIVERSAL_NAME_INFO структуры.
REMOTE_NAME_INFO_LEVEL
 Извлекает удаленную форму имени, например "\\server\share"

Если это значение задано, данные, возвращаемые в lpBuffer , сохраняются в виде REMOTE_NAME_INFO структуры.

[out] lpBuffer

Указатель на буфер для получения сведений, запрошенных пользователем. Конкретная возвращаемая структура зависит от уровня информации, указанного в dwInfoLevel.

[in, out] lpBufferSize

Указатель на размер буфера lpBuffer (в байтах ). Если вызов завершается сбоем, так как буфер недостаточно велик, это расположение будет использоваться для возврата требуемого размера буфера.

Возвращаемое значение

Если функция выполнена успешно, она должна вернуть WN_SUCCESS. В противном случае он должен вернуть код ошибки, который может быть одним из следующих.

Код возврата Описание
WN_BAD_LOCALNAME
 Значение, переданное в lpLocalPath , недопустимо.
WN_NOT_CONNECTED
 Значение, переданное в lpLocalPath , не является перенаправленным устройством.
WN_MORE_DATA
 Буфер слишком мал.
WN_NO_NETWORK
 Сеть отсутствует.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header npapi.h