WSCEnumNameSpaceProviders32, fonction (ws2spi.h)
La fonction WSCEnumNameSpaceProviders32 retourne des informations sur les fournisseurs d’espaces de noms 32 bits disponibles.
Syntaxe
INT WSAAPI WSCEnumNameSpaceProviders32(
[in, out] LPDWORD lpdwBufferLength,
[out] LPWSANAMESPACE_INFOW lpnspBuffer
);
Paramètres
[in, out] lpdwBufferLength
Lors de l’entrée, nombre d’octets contenus dans la mémoire tampon pointée par lpnspBuffer. En sortie (si la fonction échoue et que l’erreur est WSAEFAULT), nombre minimal d’octets à allouer à la mémoire tampon lpnspBuffer pour lui permettre de récupérer toutes les informations demandées. La mémoire tampon passée à WSCEnumNameSpaceProviders32 doit être suffisante pour contenir toutes les informations d’espace de noms.
[out] lpnspBuffer
Mémoire tampon remplie de structures WSANAMESPACE_INFOW . Les structures retournées sont situées consécutivement en tête de la mémoire tampon. Les informations de taille variable référencées par des pointeurs dans les structures pointent vers des emplacements dans la mémoire tampon situés entre la fin des structures de taille fixe et la fin de la mémoire tampon. Le nombre de structures renseignées est la valeur de retour de WSCEnumNameSpaceProviders32.
Valeur retournée
La fonction WSCEnumNameSpaceProviders32 retourne le nombre de structures WSANAMESPACE_INFOW copiées dans lpnspBuffer. Sinon, la valeur SOCKET_ERROR est retournée et un numéro d’erreur spécifique peut être récupéré en appelant WSAGetLastError.
| Code d'erreur | Signification |
|---|---|
| Le paramètre lpnspBuffer était un pointeur **NULL**, ou la longueur de la mémoire tampon, lpdwBufferLength, était trop petite pour recevoir toutes les structures de WSANAMESPACE_INFOW pertinentes et les informations associées. Lorsque cette erreur est retournée, la longueur de la mémoire tampon requise est retournée dans le paramètre lpdwBufferLength . | |
| Le WS2_32.DLL n’a pas été initialisé. L’application doit d’abord appeler WSAStartup avant d’appeler les fonctions Windows Sockets. | |
| La mémoire était insuffisante pour effectuer l’opération. |
Remarques
WSCEnumNameSpaceProviders32 est une version strictement 32 bits de WSAEnumNameSpaceProviders. Sur un ordinateur 64 bits, tous les appels ne sont pas spécifiquement 32 bits (par exemple, toutes les fonctions qui ne se terminent pas par « 32 ») fonctionnent sur le catalogue 64 bits natif. Les processus qui s’exécutent sur un ordinateur 64 bits doivent utiliser les appels de fonction 32 bits spécifiques pour fonctionner sur un catalogue strictement 32 bits et préserver la compatibilité. Les définitions et la sémantique des appels 32 bits spécifiques sont les mêmes que leurs équivalents natifs.
La fonction SPI 32 bits est équivalente à la fonction API native (WSAEnumNameSpaceProviders), car il n’existe aucun concept de fournisseur d’espace de noms « masqué ».
La fonction WSCEnumNameSpaceProviders32 est une fonction Unicode uniquement et retourne WSANAMESPACE_INFOEXW structures.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP Professionnel Édition x64 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008, Windows Server 2003 Édition x64 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ws2spi.h |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |