Funzione GetTypeByNameA (nspapi.h)

Articolo
11/20/2024

La funzione GetTypeByName recupera un tipo di servizio GUID per un servizio di rete specificato in base al nome.

Nota La funzione GetTypeByName è un'estensione specifica di Microsoft per la specifica Windows Sockets 1.1. Questa funzione è obsoleta. Per praticità degli sviluppatori windows Sockets 1.1, questo materiale di riferimento è incluso. Le funzioni descritte in Protocol-Independent risoluzione dei nomi forniscono funzionalità equivalenti in Windows Sockets 2.

Sintassi

INT GetTypeByNameA(
  [in]      LPSTR  lpServiceName,
  [in, out] LPGUID lpServiceType
);

Parametri

[in] lpServiceName

Puntatore a una stringa con terminazione zero che rappresenta in modo univoco il nome del servizio. Ad esempio, "MY SNA SERVER".

[in, out] lpServiceType

Puntatore a una variabile per ricevere un identificatore univoco globale (GUID) che specifica il tipo del servizio di rete. Il file di intestazione Svcguid.h include definizioni di diversi GUID tipi di servizio e macro per usarli.

Il file di intestazione Svcguid.h non viene incluso automaticamente dal file di intestazione Winsock2.h.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è zero.

Se la funzione ha esito negativo, il valore restituito è SOCKET_ERROR( - 1). Per ottenere informazioni estese sull'errore, chiamare GetLastError, che restituisce il valore di errore esteso seguente.

Valore	Significato
ERROR_SERVICE_DOES_NOT_EXIST	Il tipo di servizio specificato è sconosciuto.

Osservazioni

Nota

L'intestazione nspapi.h definisce GetTypeByName 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]
piattaforma di destinazione	Finestre
intestazione	nspapi.h
libreria	Mswsock.lib
dll	Mswsock.dll

Vedere anche

GetNameByType

Funzioni Winsock

di riferimento winsock

Condividi tramite