struttura WSANAMESPACE_INFOEXW (winsock2.h)

Articolo
11/20/2024

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;

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.

ProviderSpecific

Tipo: BLOB

BLOB di dati specifico del provider associato alla voce dello spazio dei nomi.

Osservazioni

La struttura WSANAMESPACE_INFOEX è una versione avanzata della struttura di WSANAMESPACE_INFO utilizzata dalle funzioni di 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 al WSCInstallNameSpaceEx e funzioni WSCInstallNameSpaceEx32.

Attualmente, l'unico spazio dei nomi incluso in Windows che usa informazioni nel ProviderSpecific membro 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 lpszIdentifier stringa viene definito al 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 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.