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

Требования