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

Извлекает родительский элемент указанного сетевого ресурса в иерархии обзора. Эта функция обычно вызывается для ресурсов, возвращаемых тем же поставщиком из предыдущих вызовов NPEnumResource или NPGetResourceInformation.

Синтаксис

DWORD NPGetResourceParent(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize
);

Параметры

[in] lpNetResource

Указатель на сетевой ресурс, родительский имя которого требуется. NetRESOURCE может быть получен из предыдущего вызова NPEnumResource или NPGetResourceInformation или созданного вызывающим оператором.

Поле lpRemoteName указывает удаленное имя сетевого ресурса, родительский объект которого является обязательным.

Поле lpProvider указывает поставщика для вызова. Это должно быть предоставлено.

Поле dwType заполняется, если вызывающая программа знает свое значение. В противном случае для него задано значение NULL.

Все остальные поля в NETRESOURCE игнорируются и не инициализированы.

[out] lpBuffer

Указатель на буфер для получения результата, которая является одной структурой NETRESOURCE , представляющей родительский ресурс. Возвращаются поля lpRemoteName, lpProvider, dwType, dwDisplayType и dwUsage ; все остальные поля имеют значение NULL.

Выходные данные lpRemoteName должны иметь тот же формат, что и возвращаемый из перечисления NPEnumResource, чтобы вызывающий объект смог выполнить сравнение строк с учетом регистра, чтобы определить, совпадает ли родительский ресурс, возвращаемый NPEnumResource. Если входной ресурс синтаксически имеет родительский объект, поставщик может вернуть его, не определяя, существует ли входной ресурс или его родительский ресурс. Если ресурс не имеет родительского элемента обзора в сети, lpRemoteName возвращается как NULL.

Бит RESOURCEUSAGE_CONNECTABLE в возвращаемом поле dwUsage не обязательно указывает, что ресурс может быть подключен только к нему, только если он доступен в сети.

[in, out] lpBufferSize

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

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

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

Требования