struttura WSANAMESPACE_INFOW (winsock2.h)

Articolo
11/20/2024

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;

Membri

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. È possibile installare altri provider di spazi dei nomi, 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 DIRECTORY (NTDS).
NS_PNRPNAME	Spazio dei nomi 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 dello spazio dei nomi è inattivo e non è accessibile per le query, anche se la query fa riferimento specificamente 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 dello spazio dei nomi.

Osservazioni

La struttura WSANAMESPACE_INFO viene utilizzata dalle funzioni di e WSCEnumNameSpaceProviders WSCEnumNameSpaceProviders3 2 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 al WSCInstallNameSpace e funzioni 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 lpszIdentifier stringa 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 di 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	winsock2.h