Condividi tramite


Funzione GetTypeByNameA (nspapi.h)

La funzione GetTypeByName recupera un GUID del tipo di servizio 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 Risoluzione dei nomi indipendenti dal protocollo 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 tipi di servizio GUID 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 sull'errore estese, chiamare GetLastError, che restituisce il seguente valore di errore esteso.

Valore Significato
ERROR_SERVICE_DOES_NOT_EXIST
Il tipo di servizio specificato è sconosciuto.

Commenti

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 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

GetNameByType

Funzioni Winsock

Informazioni di riferimento su Winsock