struttura WSANAMESPACE_INFOEXW (winsock2.h)
La struttura WSANAMESPACE_INFOEX contiene tutte le informazioni di registrazione per un provider di spazi dei nomi.
Sintassi
typedef struct _WSANAMESPACE_INFOEXW {
GUID NSProviderId;
DWORD dwNameSpace;
BOOL fActive;
DWORD dwVersion;
LPWSTR lpszIdentifier;
BLOB ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;
Members
NSProviderId
Tipo: GUID
GUID univoco per questo provider dello spazio dei nomi.
dwNameSpace
Tipo: DWORD
Spazio dei nomi supportato da questo provider.
I valori possibili per il membro dwNameSpace sono elencati nel file di inclusione Winsock2.h . Diversi provider di spazi dei nomi sono inclusi in Windows Vista e versioni successive. È possibile installare altri provider di spazi dei nomi, pertanto i valori possibili seguenti sono solo quelli comunemente disponibili. Sono possibili molti altri valori.
fActive
Tipo: BOOL
Se TRUE, indica che questo provider di spazi dei nomi è attivo. Se FALSE, il provider dello spazio dei nomi è inattivo e non è accessibile per le query, anche se la query fa riferimento in modo specifico a questo provider dello spazio dei nomi.
dwVersion
Tipo: DWORD
Numero di versione del provider dello spazio dei nomi.
lpszIdentifier
Tipo: LPTSTR
Stringa di visualizzazione che identifica il provider dello spazio dei nomi.
ProviderSpecific
Tipo: BLOB
BLOB di dati specifico del provider associato alla voce dello spazio dei nomi.
Commenti
La struttura WSANAMESPACE_INFOEX è una versione avanzata della struttura WSANAMESPACE_INFO usata dalle funzioni WSAEnumNameSpaceProvidersEx e WSCEnumNameSpaceProvidersEx32 per restituire informazioni sui provider di spazi dei nomi disponibili. La struttura WSANAMESPACE_INFOEX contiene il BLOB di dati specifico del provider associato alla voce dello spazio dei nomi passata nel parametro lpProviderInfo alle funzioni WSCInstallNameSpaceEx e WSCInstallNameSpaceEx32 .
Attualmente, l'unico spazio dei nomi incluso in Windows che usa le informazioni nel membro ProviderSpecific della struttura WSANAMESPACE_INFOEX sono provider di spazi dei nomi per lo spazio dei nomi NS_EMAIL. Il formato del membro ProviderSpecific per un provider di spazi dei nomi NS_EMAIL è una struttura NAPI_PROVIDER_INSTALLATION_BLOB .
Quando viene definito UNICODE o _UNICODE, WSANAMESPACE_INFOEX viene definito per WSANAMESPACE_INFOEXW, la versione Unicode di questa struttura e il membro stringa lpszIdentifier viene definito nel tipo di dati LPWSTR .
Quando UNICODE o _UNICODE non è definito, WSANAMESPACE_INFOEX viene definito per WSANAMESPACE_INFOEXA, la versione ANSI di questa struttura e il membro stringa lpszIdentifier viene definito al tipo di dati LPSTR .
La funzione WSCEnumNameSpaceProvidersEx32 è una funzione solo Unicode e restituisce WSANAMESPACE_INFOEXW strutture.
Nota
L'intestazione winsock2.h definisce WSANAMESPACE_INFOEX come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | winsock2.h |