WSANAMESPACE_INFOW struttura (winsock2.h)

Articolo
08/27/2023

La struttura WSANAMESPACE_INFO contiene tutte le informazioni di registrazione per un provider di spazi dei nomi.

Sintassi

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

Members

NSProviderId

Tipo: GUID

GUID univoco per questo provider di spazi 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. Altri provider di spazi dei nomi possono essere installati, pertanto i valori possibili seguenti sono solo quelli comunemente disponibili. Sono possibili molti altri valori.

Valore	Significato
NS_BTH	Spazio dei nomi Bluetooth. Questo identificatore dello spazio dei nomi è supportato in Windows Vista e versioni successive.
NS_DNS	Spazio dei nomi DNS (Domain Name System).
NS_EMAIL	Spazio dei nomi di posta elettronica. Questo identificatore dello spazio dei nomi è supportato in Windows Vista e versioni successive.
NS_NLA	Spazio dei nomi NLA (Network Location Awareness). Questo identificatore dello spazio dei nomi è supportato in Windows XP e versioni successive.
NS_NTDS	Spazio dei nomi NT (NTDS) del servizio directory Windows NT.
NS_PNRPNAME	Spazio del nome peer-to-peer per un nome peer specifico. Questo identificatore dello spazio dei nomi è supportato in Windows Vista e versioni successive.
NS_PNRPCLOUD	Spazio dei nomi peer-to-peer per una raccolta di nomi peer. Questo identificatore dello spazio dei nomi è supportato in Windows Vista e versioni successive.

fActive

Tipo: BOOL

Se TRUE, indica che questo provider di spazi dei nomi è attivo. Se FALSE, il provider di spazi dei nomi è inattivo e non è accessibile per le query, anche se la query fa riferimento in modo specifico a questo provider di spazi dei nomi.

dwVersion

Tipo: DWORD

Numero di versione del provider dello spazio dei nomi.

lpszIdentifier

Tipo: LPTSTR

Stringa di visualizzazione che identifica il provider di spazi dei nomi.

Commenti

La struttura WSANAMESPACE_INFO viene usata dalle funzioni WSAEnumNameSpaceProviders e WSCEnumNameSpaceProviders32 per restituire informazioni sui provider di spazi dei nomi disponibili. La struttura WSANAMESPACE_INFO contiene le informazioni specifiche del provider sulla voce dello spazio dei nomi passata alle funzioni WSCInstallNameSpace e WSCInstallNameSpace32 quando è stato installato il provider di spazi dei nomi.

Quando viene definito UNICODE o _UNICODE, WSANAMESPACE_INFO viene definito per WSANAMESPACE_INFOW, la versione Unicode di questa struttura di dati e il membro stringa lpszIdentifier viene definito al tipo di dati LPWSTR .

Quando UNICODE o _UNICODE non è definito, WSANAMESPACE_INFO viene definito per WSANAMESPACE_INFOA, la versione ANSI di questa struttura dati e il membro stringa lpszIdentifier viene definito al tipo di dati LPSTR .

In Windows Vista e versioni successive, WSANAMESPACE_INFOEX, una versione avanzata della struttura WSANAMESPACE_INFO viene restituita dalle chiamate alle funzioni WSAEnumNameSpaceProvidersEx e WSCEnumNameSpaceProvidersEx32

Nota

L'intestazione winsock2.h definisce WSANAMESPACE_INFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	winsock2.h