NPEnumResource, fonction (npapi.h)

Effectue une énumération basée sur un handle retourné par NPOpenEnum.

Syntaxe

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

Paramètres

[in] hEnum

Handle obtenu à partir d’un appel NPOpenEnum .

[in, out] lpcCount

Pointeur vers le nombre d’entrées demandées. Il peut être 0xFFFFFFFF de demander autant d’entrées que possible. Si l’appel réussit, cet emplacement reçoit le nombre d’entrées réellement lues.

[out] lpBuffer

Pointeur vers la mémoire tampon pour recevoir le résultat d’énumération, qui est retourné sous la forme d’un tableau d’entrées NETRESOURCE . La mémoire tampon est valide jusqu’à l’appel suivant à l’aide de hEnum.

[in, out] lpBufferSize

Pointeur vers la taille, en octets, de la mémoire tampon passée à l’appel de fonction lors de l’entrée. Si la mémoire tampon est trop petite pour même une entrée, cela doit contenir, à la sortie, le nombre d’octets nécessaires pour lire une entrée. Cette valeur est définie uniquement si le code de retour est WN_MORE_DATA.

Valeur retournée

Si la fonction réussit, elle doit retourner WN_SUCCESS. L’appelant peut continuer à appeler NPEnumResource pour continuer l’énumération. Sinon, il doit retourner l’un des codes d’erreur suivants.

Remarques

Lorsque cette fonction est appelée, le fournisseur doit remplir la mémoire tampon avec le nombre demandé d’entrées (ou le nombre maximal qui peut s’adapter). Les structures NETRESOURCE retournées doivent se trouver contiguëment à la tête de la mémoire tampon, comme un tableau de ces structures. Les pointeurs de ces structures doivent pointer vers des emplacements dans la mémoire tampon. Par conséquent, les données référencées par ces pointeurs doivent se trouver à la fin de la mémoire tampon, après le tableau de structures. Il incombe au fournisseur de empaqueter correctement ces informations.

Spécifications