WSCEnumNameSpaceProviders32, fonction (ws2spi.h)

Article
03/04/2024

La fonction WSCEnumNameSpaceProviders32 retourne des informations sur les fournisseurs d’espaces de noms 32 bits disponibles.

Note Cet appel est une version strictement 32 bits de WSAEnumNameSpaceProviders à utiliser sur les plateformes 64 bits. Il est fourni pour permettre aux processus 64 bits d’accéder aux catalogues 32 bits.

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
WSAEFAULT	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 .
WSANOTINITIALISED	Le WS2_32.DLL n’a pas été initialisé. L’application doit d’abord appeler WSAStartup avant d’appeler les fonctions Windows Sockets.
WSA_NOT_ENOUGH_MEMORY	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

Voir aussi

WSAEnumNameSpaceProviders

WSANAMESPACE_INFOW

WSCInstallNameSpace32

WSCInstallNameSpaceEx32

Partager via