Funzione WSCEnumNameSpaceProviders32 (ws2spi.h)
La funzione WSCEnumNameSpaceProviders32 restituisce informazioni sui provider di spazi dei nomi a 32 bit disponibili.
Sintassi
INT WSAAPI WSCEnumNameSpaceProviders32(
[in, out] LPDWORD lpdwBufferLength,
[out] LPWSANAMESPACE_INFOW lpnspBuffer
);
Parametri
[in, out] lpdwBufferLength
In input, il numero di byte contenuti nel buffer a cui punta lpnspBuffer. Nell'output (se la funzione ha esito negativo e l'errore è WSAEFAULT), il numero minimo di byte da allocare per il buffer lpnspBuffer per consentire il recupero di tutte le informazioni richieste. Il buffer passato a WSCEnumNameSpaceProviders32 deve essere sufficiente per contenere tutte le informazioni sullo spazio dei nomi.
[out] lpnspBuffer
Buffer pieno di strutture WSANAMESPACE_INFOW . Le strutture restituite si trovano consecutivamente all'inizio del buffer. Le informazioni sulle dimensioni delle variabili a cui fanno riferimento i puntatori nelle strutture puntano alle posizioni all'interno del buffer che si trovano tra la fine delle strutture a dimensione fissa e la fine del buffer. Il numero di strutture compilate è il valore restituito di WSCEnumNameSpaceProviders32.
Valore restituito
La funzione WSCEnumNameSpaceProviders32 restituisce il numero di strutture WSANAMESPACE_INFOW copiate in lpnspBuffer. In caso contrario, viene restituito il valore SOCKET_ERROR e è possibile recuperare un numero di errore specifico chiamando WSAGetLastError.
| Codice di errore | Significato |
|---|---|
| Il parametro lpnspBuffer era un puntatore **NULL** o la lunghezza del buffer, lpdwBufferLength, era troppo piccola per ricevere tutte le strutture WSANAMESPACE_INFOW pertinenti e le informazioni associate. Quando viene restituito questo errore, la lunghezza del buffer necessaria viene restituita nel parametro lpdwBufferLength . | |
| Il WS2_32.DLL non è stato inizializzato. L'applicazione deve prima chiamare WSAStartup prima di chiamare qualsiasi funzione Di Windows Sockets. | |
| Memoria insufficiente per eseguire l'operazione. |
Commenti
WSCEnumNameSpaceProviders32 è una versione rigorosa a 32 bit di WSAEnumNameSpaceProviders. In un computer a 64 bit tutte le chiamate non sono specifiche a 32 bit (ad esempio, tutte le funzioni che non terminano in "32") operano sul catalogo nativo a 64 bit. I processi eseguiti in un computer a 64 bit devono usare le chiamate di funzione a 32 bit specifiche per operare su un catalogo a 32 bit e mantenere la compatibilità. Le definizioni e la semantica delle chiamate a 32 bit specifiche sono le stesse delle rispettive controparti native.
La funzione SPI a 32 bit equivale alla funzione API nativa (WSAEnumNameSpaceProviders) perché non esiste alcun concetto di provider di spazi dei nomi "nascosto".
La funzione WSCEnumNameSpaceProviders32 è una funzione solo Unicode e restituisce WSANAMESPACE_INFOEXW strutture.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista, Windows XP Professional x64 Edition [solo app desktop] |
| Server minimo supportato | Windows Server 2008, Windows Server 2003 x64 Edition [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2spi.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |