Função NPEnumResource (npapi.h)

Executa uma enumeração com base em um identificador retornado por NPOpenEnum.

Sintaxe

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

Parâmetros

[in] hEnum

Identificador obtido de uma chamada NPOpenEnum .

[in, out] lpcCount

Ponteiro para o número de entradas solicitadas. Pode ser 0xFFFFFFFF solicitar o maior número possível de entradas. Se a chamada for bem-sucedida, esse local receberá o número de entradas realmente lidas.

[out] lpBuffer

Ponteiro para o buffer para receber o resultado da enumeração, que é retornado como uma matriz de entradas NETRESOURCE . O buffer é válido até a próxima chamada usando hEnum.

[in, out] lpBufferSize

Ponteiro para o tamanho, em bytes, do buffer passado para a chamada de função na entrada. Se o buffer for muito pequeno para uma entrada, isso deverá conter, na saída, o número de bytes necessários para ler uma entrada. Esse valor será definido somente se o código de retorno for WN_MORE_DATA.

Retornar valor

Se a função for bem-sucedida, ela deverá retornar WN_SUCCESS. O chamador pode continuar a chamar NPEnumResource para continuar a enumeração. Caso contrário, ele deverá retornar um dos seguintes códigos de erro.

Comentários

Quando essa função é chamada, o provedor deve preencher o buffer com o número solicitado de entradas (ou o máximo que pode caber). As estruturas NETRESOURCE retornadas devem estar localizadas contíguamente na cabeça do buffer, como uma matriz dessas estruturas. Os ponteiros nessas estruturas devem apontar para locais dentro do buffer. Portanto, os dados referenciados por esses ponteiros devem estar localizados no final do buffer, após a matriz de estruturas. É responsabilidade do provedor empacotar essas informações corretamente.

Requisitos