NPOpenEnum, fonction (npapi.h)

Ouvre une énumération des ressources réseau ou des connexions existantes. La fonction NPOpenEnum doit être appelée pour obtenir un handle valide pour une énumération.

Syntaxe

DWORD NPOpenEnum(
  [in]  DWORD          dwScope,
  [in]  DWORD          dwType,
  [in]  DWORD          dwUsage,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPHANDLE       lphEnum
);

Paramètres

[in] dwScope

Détermine l’étendue de l’énumération. Il peut s’agir de l’un des éléments suivants.

[in] dwType

Spécifie le type de ressources intéressantes. Il s’agit d’un masque de bits, qui peut être n’importe quelle combinaison des indicateurs suivants.

Si dwType a la valeur 0 ou n’est qu’RESOURCEUSAGE_ATTACHED, tous les types de ressources sont retournés. Si un fournisseur n’a pas la possibilité de faire la distinction entre les ressources d’impression et de disque au même niveau, il peut retourner toutes les ressources.

[in] dwUsage

Spécifie l’utilisation des ressources intéressées. Il s’agit d’un masque de bits, qui peut être n’importe quelle combinaison des indicateurs suivants.

Le masque de bits peut être égal à zéro pour correspondre à tous les indicateurs. Ce paramètre peut être ignoré si dwScope n’est pas défini sur RESOURCE_GLOBALNET.

[in] lpNetResource

Pointeur vers le conteneur pour effectuer l’énumération. Le NETRESOURCE a pu être obtenu par le biais d’un appel NPEnumResource précédent, ou construit par l’appelant, ou il peut être NULL. S’il s’agit de NULL ou si le champ lpRemoteName de NETRESOURCE a la valeur NULL, le fournisseur doit énumérer le niveau supérieur de son réseau. Notez que cela signifie qu’un fournisseur ne peut pas utiliser un lpRemoteName de NULL pour représenter n’importe quelle ressource réseau. Un appelant démarre normalement en appelant NPOpenEnum avec ce paramètre défini sur NULL , puis utilise les résultats retournés pour une énumération supplémentaire. Si le programme appelant connaît exactement le fournisseur et le chemin d’accès distant à partir duquel énumérer, il peut générer sa propre structure NETRESOURCE à transmettre, en remplissant les champs lpProvider et lpRemoteName . Notez que si dwScope est RESOURCE_CONNECTED ou RESOURCE_CONTEXT, ce paramètre est NULL.

[out] lphEnum

Pointeur vers un handle qui peut être utilisé par la fonction NPEnumResource . Une fois que vous avez terminé d’utiliser le handle, relâchez le handle en appelant la fonction NPCloseEnum .

Valeur retournée

Si la fonction réussit, elle doit retourner WN_SUCCESS. Sinon, il doit retourner un code d’erreur qui peut inclure l’un des éléments suivants.

Spécifications