Funzione SetServiceA (nspapi.h)

  • Articolo

La funzione SetService registra o rimuove dal Registro di sistema un servizio di rete all'interno di uno o più spazi dei nomi. La funzione può anche aggiungere o rimuovere un tipo di servizio di rete all'interno di uno o più spazi dei nomi.

Nota La funzione SetService è obsoleta. Le funzioni descritte in Risoluzione dei nomi indipendenti dal protocollo forniscono funzionalità equivalenti in Windows Sockets 2. Per praticità degli sviluppatori Windows Sockets 1.1, il materiale di riferimento è il seguente.
 

Sintassi

INT SetServiceA(
  [in]           DWORD                dwNameSpace,
  [in]           DWORD                dwOperation,
  [in]           DWORD                dwFlags,
  [in]           LPSERVICE_INFOA      lpServiceInfo,
  [in, optional] LPSERVICE_ASYNC_INFO lpServiceAsyncInfo,
  [out]          LPDWORD              lpdwStatusFlags
);

Parametri

[in] dwNameSpace

Spazio dei nomi, o un set di spazi dei nomi predefiniti, in cui funzionerà.

Utilizzare una delle costanti seguenti per specificare uno spazio dei nomi.

Valore Significato
NS_DEFAULT
 Set di spazi dei nomi predefiniti. La funzione esegue una query su ogni spazio dei nomi all'interno di questo set. Il set di spazi dei nomi predefiniti include in genere tutti gli spazi dei nomi installati nel sistema. Gli amministratori di sistema, tuttavia, possono escludere determinati spazi dei nomi dal set. NS_DEFAULT è il valore che la maggior parte delle applicazioni deve usare per dwNameSpace.
NS_DNS
 Domain Name System utilizzato in Internet per risolvere il nome dell'host.
NS_NDS
 Provider NetWare 4.
NS_NETBT
 NetBIOS sul livello TCP/IP. Tutti i sistemi Windows registrano i nomi dei computer con NetBIOS. Questo spazio dei nomi viene usato per convertire un nome computer in un indirizzo IP che utilizza questa registrazione.
NS_SAP
 Protocollo NetWare Service Advertising. In questo modo è possibile accedere al bindery NetWare, se appropriato. NS_SAP è uno spazio dei nomi dinamico che consente la registrazione dei servizi.
NS_TCPIP_HOSTS
 Valore di ricerca nel <file systemroot>\system32\drivers\etc\posts.
NS_TCPIP_LOCAL
 Meccanismi di risoluzione dei nomi TCP/IP locali, inclusi i confronti con il nome host locale e il valore di ricerca nella cache dell'host ai mapping degli indirizzi IP.

[in] dwOperation

Operazione che verrà eseguita dalla funzione. Usare uno dei valori seguenti per specificare un'operazione:

Valore Significato
SERVICE_REGISTER
 Registrare il servizio di rete con lo spazio dei nomi . Questa operazione può essere usata con i flag di bit SERVICE_FLAG_DEFER e SERVICE_FLAG_HARD.
SERVICE_DEREGISTER
 Rimuovere dal Registro di sistema il servizio di rete dallo spazio dei nomi . Questa operazione può essere usata con i flag di bit SERVICE_FLAG_DEFER e SERVICE_FLAG_HARD.
SERVICE_FLUSH
 Eseguire qualsiasi operazione chiamata con il flag di bit SERVICE_FLAG_DEFER impostato su uno.
SERVICE_ADD_TYPE
 Aggiungere un tipo di servizio allo spazio dei nomi .

Per questa operazione, utilizzare il membro ServiceSpecificInfo della struttura SERVICE_INFO a cui punta lpServiceInfo per passare una struttura SERVICE_TYPE_INFO_ABS . È inoltre necessario impostare il membro ServiceType della struttura SERVICE_INFO . Altri membri SERVICE_INFO vengono ignorati.
SERVICE_DELETE_TYPE
 Rimuovere un tipo di servizio, aggiunto da una chiamata precedente che specifica l'operazione di SERVICE_ADD_TYPE, dallo spazio dei nomi .

[in] dwFlags

Set di flag di bit che modificano l'operazione della funzione. È possibile impostare uno o più flag di bit seguenti:

Valore Significato
SERVICE_FLAG_DEFER
 Questo flag di bit è valido solo se l'operazione è SERVICE_REGISTER o SERVICE_DEREGISTER.

Se questo flag di bit è uno e è valido, il provider dello spazio dei nomi deve rinviare l'operazione di registrazione o annullamento della registrazione fino a quando non viene richiesta un'operazione di SERVICE_FLUSH.
SERVICE_FLAG_HARD
 Questo flag di bit è valido solo se l'operazione è SERVICE_REGISTER o SERVICE_DEREGISTER.

Se questo flag di bit è uno e è valido, il provider dello spazio dei nomi aggiorna le informazioni pertinenti sull'archivio permanente quando viene eseguita l'operazione.

Ad esempio: se l'operazione comporta la annullamento della registrazione in uno spazio dei nomi che usa un archivio permanente, il provider dello spazio dei nomi rimuoverà le informazioni pertinenti sull'archivio permanente.

[in] lpServiceInfo

Puntatore a una struttura di SERVICE_INFO che contiene informazioni sul servizio di rete o sul tipo di servizio.

[in, optional] lpServiceAsyncInfo

Riservato per utilizzi futuri. Deve essere impostato su NULL.

[out] lpdwStatusFlags

Set di flag di bit che ricevono informazioni sullo stato della funzione. Viene definito il flag di bit seguente:

Valore Significato
SET_SERVICE_ PARTIAL_SUCCESS
 Uno o più provider di spazi dei nomi non sono riusciti a eseguire correttamente l'operazione richiesta.

Valore restituito

Se la funzione ha esito negativo, il valore restituito viene SOCKET_ERROR. Per informazioni dettagliate sull'errore, chiamare GetLastError. GetLastError può restituire il seguente valore di errore esteso.

Codice di errore Significato
ERROR_ALREADY_ REGISTRATO
 La funzione ha tentato di registrare un servizio già registrato.

Commenti

Nota

L'intestazione nspapi.h definisce SetService 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 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione nspapi.h
Libreria Mswsock.lib
DLL Mswsock.dll

Vedi anche

GetService

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

Funzioni Winsock

Informazioni di riferimento su Winsock