DnsServiceRegister-Funktion (windns.h)

Wird verwendet, um einen auffindbaren Dienst auf diesem Gerät zu registrieren.

Syntax

DWORD DnsServiceRegister(
  PDNS_SERVICE_REGISTER_REQUEST pRequest,
  PDNS_SERVICE_CANCEL           pCancel
);

Parameter

pRequest

Ein Zeiger auf eine DNS_SERVICE_REGISTER_REQUEST-Struktur , die Informationen zum zu registrierenden Dienst enthält.

pCancel

Ein optionaler (ggf. nullptr) Zeiger auf eine DNS_SERVICE_CANCEL Struktur, die zum Abbrechen eines ausstehenden asynchronen Registrierungsvorgangs verwendet werden kann. Andernfalls nullptrmuss dieses Handle gültig bleiben, bis die Registrierung abgebrochen wird.

Rückgabewert

Bei erfolgreicher Ausführung wird DNS_REQUEST_PENDING zurückgegeben. Gibt andernfalls den entsprechenden DNS-spezifischen Fehlercode zurück, wie in Winerror.hdefiniert. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Diese Funktion ist asynchron. Der Registrierungsrückruf wird aufgerufen, sobald die Registrierung erfolgreich ist. Um die Registrierung des Diensts aufzuheben, rufen Sie DnsServiceDeRegister auf.   Die Registrierung ist an die Lebensdauer des aufrufenden Prozesses gebunden. Wenn der Prozess abläuft, wird die Registrierung des Diensts automatisch aufgehoben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	windns.h
Bibliothek	dnsapi.lib
DLL	dnsapi.dll