struttura SERVICE_INFOA (nspapi.h)

Articolo
11/20/2024

La struttura SERVICE_INFO contiene informazioni su un servizio di rete o un tipo di servizio di rete.

Sintassi

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

Membri

lpServiceType

Tipo: LPGUID

Puntatore a un GUID che è il tipo del servizio di rete.

lpServiceName

Tipo: LPTSTR

Puntatore a un NULLstringa con terminazione che corrisponde al nome del servizio di rete.

Se si chiama la funzione SetService con il parametro dwNameSpace impostato su NS_DEFAULT, il nome del servizio di rete deve essere un nome comune. Un nome comune è quello che il servizio di rete è comunemente noto come . Un esempio di nome comune per un servizio di rete è "My SQL Server".

Se si chiama la funzione SetService con il parametro dwNameSpace impostato su un nome di servizio specifico, il nome del servizio di rete può essere un nome comune o un nome distinto. Un nome distinto distingue il servizio in una posizione univoca con un servizio directory. Un esempio di nome distinto per un servizio di rete è "MS\SYS\NT\DEV\My SQL Server".

lpComment

Tipo: LPTSTR

Puntatore a un NULLstringa con terminazione che rappresenta un commento o una descrizione per il servizio di rete. Ad esempio, "Usato per gli aggiornamenti di sviluppo".

lpLocale

Tipo: LPTSTR

Puntatore a un NULLstringa con terminazione contenente informazioni sulle impostazioni locali.

dwDisplayHint

Tipo: DWORD

Suggerimento su come visualizzare il servizio di rete in un'interfaccia utente di esplorazione di rete. Può trattarsi di uno dei valori seguenti.

Valore	Significato
RESOURCEDISPLAYTYPE_DOMAIN	Visualizzare il servizio di rete come dominio.
RESOURCEDISPLAYTYPE_FILE	Visualizzare il servizio di rete come file.
RESOURCEDISPLAYTYPE_GENERIC	Il metodo utilizzato per visualizzare l'oggetto non è importante.
RESOURCEDISPLAYTYPE_GROUP	Visualizzare il servizio di rete come gruppo.
RESOURCEDISPLAYTYPE_SERVER	Visualizzare il servizio di rete come server.
RESOURCEDISPLAYTYPE_SHARE	Visualizzare il servizio di rete come sharepoint.
RESOURCEDISPLAYTYPE_TREE	Visualizzare il servizio di rete come albero.

dwVersion

Tipo: DWORD

Versione del servizio di rete. La parola alta di questo valore specifica un numero di versione principale. La parola bassa di questo valore specifica un numero di versione secondaria.

dwTime

Tipo: DWORD

Riservato per uso futuro. Deve essere zero.

lpMachineName

Tipo: LPTSTR

Puntatore a un NULLstringa con terminazione che corrisponde al nome del computer in cui è in esecuzione il servizio di rete.

lpServiceAddress

Tipo: LPSERVICE_ADDRESSES

Puntatore a una struttura SERVICE_ADDRESSES che contiene una matrice di strutture SERVICE_ADDRESS. Ogni struttura SERVICE_ADDRESS contiene informazioni su un indirizzo del servizio di rete.

Un servizio di rete può chiamare la funzione getsockname per determinare l'indirizzo locale del sistema.

ServiceSpecificInfo

Tipo: BLOB

Struttura BLOB che specifica le informazioni definite dal servizio.

Nota In generale, i dati a cui fa riferimento il membro pBlob Data della struttura BLOB non devono contenere puntatori. Ciò è dovuto al fatto che solo il servizio di rete conosce il formato dei dati; la copia dei dati senza tali conoscenze causerebbe l'invalidazione del puntatore. Se i dati a cui puntano pBlobData contengono elementi di dimensioni variabili, è possibile utilizzare gli offset da pBlobData per indicare la posizione di tali elementi. Esiste un'eccezione a questa regola generale: quando pBlobData punta a una struttura SERVICE_TYPE_INFO_ABS. Ciò è possibile perché sia la struttura SERVICE_TYPE_INFO_ABS che tutte le strutture SERVICE_TYPE_VALUE_ABS che contiene sono predefinite e pertanto i relativi formati sono noti al sistema operativo.

Osservazioni

Nota

L'intestazione nspapi.h definisce SERVICE_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	nspapi.h