Compartir a través de

Función NPEnumResource (npapi.h)

  • Artículo

Realiza una enumeración basada en un identificador devuelto por NPOpenEnum.

Sintaxis

DWORD NPEnumResource(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parámetros

[in] hEnum

Identificador obtenido de una llamada NPOpenEnum .

[in, out] lpcCount

Puntero al número de entradas solicitadas. Puede ser 0xFFFFFFFF solicitar tantas entradas como sea posible. Si la llamada se realiza correctamente, esta ubicación recibirá el número de entradas que realmente se leen.

[out] lpBuffer

Puntero al búfer para recibir el resultado de la enumeración, que se devuelve como una matriz de entradas NETRESOURCE . El búfer es válido hasta la siguiente llamada mediante hEnum.

[in, out] lpBufferSize

Puntero al tamaño, en bytes, del búfer pasado a la llamada de función en la entrada. Si el búfer es demasiado pequeño para incluso una entrada, debe contener, al salir, el número de bytes necesarios para leer una entrada. Este valor solo se establece si el código devuelto es WN_MORE_DATA.

Valor devuelto

Si la función se ejecuta correctamente, debe devolver WN_SUCCESS. El autor de la llamada puede seguir llamando a NPEnumResource para continuar con la enumeración. De lo contrario, debe devolver uno de los siguientes códigos de error.

Código devuelto Descripción
WN_NO_MORE_ENTRIES
 No hay más entradas. La enumeración se completó correctamente. Cuando esto ocurre, el contenido del búfer de devolución, lpBuffer, no está definido.
WN_MORE_DATA
 El búfer es demasiado pequeño para contener incluso una sola entrada.
WN_BAD_HANDLE
 hEnum no es un identificador válido.
WN_NO_NETWORK
 La red no está presente. Esta condición se comprueba antes de que hEnum se pruebe para comprobar su validez.

Comentarios

Cuando se llama a esta función, el proveedor debe rellenar el búfer con el número solicitado de entradas (o el máximo que puede caber). Las estructuras de NETRESOURCE devueltas se deben ubicar de forma contigua en el encabezado del búfer, como una matriz de estas estructuras. Los punteros de estas estructuras deben apuntar a ubicaciones dentro del búfer. Por lo tanto, los datos a los que hacen referencia estos punteros deben encontrarse al final del búfer, después de la matriz de estructuras. Es responsabilidad del proveedor empaquetar esta información correctamente.

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