Función NPGetResourceParent (npapi.h)

Recupera el elemento primario de un recurso de red especificado en la jerarquía de exploración. Normalmente, se llama a esta función para los recursos devueltos por el mismo proveedor desde llamadas anteriores a NPEnumResource o NPGetResourceInformation.

Sintaxis

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

Parámetros

[in] lpNetResource

Puntero al recurso de red cuyo nombre primario es necesario. NETRESOURCE podría haberse obtenido de una llamada anterior a NPEnumResource o NPGetResourceInformation o construido por el autor de la llamada.

El campo lpRemoteName especifica el nombre remoto del recurso de red cuyo elemento primario es necesario.

El campo lpProvider especifica el proveedor al que se va a llamar. Debe proporcionarse.

El campo dwType se rellena si el programa de llamada conoce su valor. De lo contrario, se establece en NULL.

Todos los demás campos de NETRESOURCE se omiten y no se inicializan.

[out] lpBuffer

Puntero a un búfer para recibir el resultado, que es una única estructura NETRESOURCE que representa el recurso primario. Se devuelven los campos lpRemoteName, lpProvider, dwType, dwDisplayType y dwUsage; todos los demás campos se establecen en NULL.

La salida lpRemoteName debe tener el mismo formato que el devuelto por NPEnumResource para que el autor de la llamada pueda realizar una comparación de cadenas que distingue mayúsculas de minúsculas para determinar si el recurso primario es el mismo que el devuelto por NPEnumResource. Si el recurso de entrada tiene sintácticamente un elemento primario, el proveedor puede devolverlo, sin determinar si el recurso de entrada o su elemento primario existen realmente. Si un recurso no tiene ningún elemento primario de exploración en la red, lpRemoteName se devuelve como NULL.

El RESOURCEUSAGE_CONNECTABLE bit del campo dwUsage devuelto no indica necesariamente que el recurso se pueda conectar actualmente, solo que el recurso se pueda conectar cuando esté disponible en la red.

[in, out] lpBufferSize

Puntero a una ubicación que especifica el tamaño, en bytes, del búfer al que apunta el parámetro lpBuffer . Si el búfer es demasiado pequeño para el resultado, la función coloca el tamaño de búfer necesario en esta ubicación y devuelve el error WN_MORE_DATA.

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.

Requisitos