getservbyname-Funktion (winsock.h)
Die getservbyname-Funktion ruft Dienstinformationen ab, die einem Dienstnamen und Protokoll entsprechen.
Syntax
servent * getservbyname(
[in] const char *name,
[in] const char *proto
);
Parameter
[in] name
Ein Zeiger auf einen Null-beendeten Dienstnamen.
[in] proto
Ein Zeiger auf einen null-beendeten Protokollnamen. Wenn dieser Zeiger NULL ist, gibt die getservbyname-Funktionden ersten Diensteintrag zurück, bei dem der Name dem s_name Member der Serventstruktur oder dem s_aliases Member der Servent-Struktur entspricht. Andernfalls entspricht getservbyname sowohl dem Namen als auch dem Proto.
Rückgabewert
Wenn kein Fehler auftritt, gibt getservbyname einen Zeiger an die Serventstruktur zurück. Andernfalls gibt es einen Nullzeiger zurück, und eine bestimmte Fehlernummer kann abgerufen werden, indem WSAGetLastError aufgerufen wird.
| Fehlercode | Bedeutung |
|---|---|
| Ein erfolgreicher WSAStartup-Aufruf muss auftreten, bevor diese Funktion verwendet wird. | |
| Das Netzwerk-Subsystem ist fehlgeschlagen. | |
| Autoritative Antwortdienst nicht gefunden. | |
| Ein nichtauthoritativer Dienst wurde nicht gefunden oder ein Serverfehler aufgetreten. | |
| Nicht wiederherstellbare Fehler, die Dienstdatenbank ist nicht zugänglich. | |
| Gültiger Name, kein Datensatz des angeforderten Typs. | |
| Ein blockierter Windows Sockets 1.1-Aufruf ist in Bearbeitung, oder der Dienstanbieter verarbeitet weiterhin eine Rückruffunktion. | |
| Ein blockierter Windows Socket 1.1-Anruf wurde über WSACancelBlockingCall abgebrochen. |
Bemerkungen
Die Getservbyname-Funktion gibt einen Zeiger auf die Serventstruktur zurück, die den Namen und die Dienstnummer enthält, die der Zeichenfolge im Namenparameter entspricht. Alle Zeichenfolgen sind null-beendet.
Der Zeiger, der an die vom Windows Sockets-Bibliothek zugewiesene Dienststruktur zurückgibt. Die Anwendung darf niemals versuchen, diese Struktur zu ändern oder eine ihrer Komponenten freizuhalten. Darüber hinaus wird nur eine Kopie dieser Struktur pro Thread zugewiesen, sodass die Anwendung alle benötigten Informationen kopieren sollte, bevor sie andere Windows Sockets-Funktionsaufrufe ausstellen.
Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps auf Windows Phone 8 und höher unterstützt.
Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8.1, Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winsock.h (enthalten Winsock2.h) |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |