Поделиться через

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

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

Синтаксис

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

Параметры

[in] lpLocalPath

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

[in] dwInfoLevel

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

Ценность Meaning
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. В противном случае он должен вернуть код ошибки, который может быть одним из следующих.

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

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
Header npapi.h
Library davclnt.lib
  • Last updated on