Compartir a través de

Función NPGetResourceParent (npapi.h)

  • Artículo

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.

Código devuelto Descripción
WN_MORE_DATA
 El búfer de entrada es demasiado pequeño.
WN_BAD_NETNAME
 Este proveedor no posee el recurso especificado por lpNetResource (o el recurso no es válido sintácticamente).
WN_BAD_VALUE
 DwUsage o dwType no es válido o hay una combinación incorrecta de parámetros especificados (por ejemplo, lpRemoteName no es válido sintácticamente para dwType).
WN_NOT_AUTHENTICATED
 El autor de la llamada no se ha autenticado en la red.
WN_ACCESS_DENIED
 El autor de la llamada se ha autenticado en la red, pero no tiene permisos suficientes.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado npapi.h