PxeGetServerInfoEx-Funktion (wdspxe.h)

Gibt Informationen zum PXE-Server zurück.

Weitere Informationen zur option OPTION_SERVERID finden Entwickler im Dynamic Host Configuration Protocol for IPv6 (RFC 3315), das von der Internet Engineering Task Force (IETF) verwaltet wird.

Syntax

DWORD PXEAPI PxeGetServerInfoEx(
  [in]  PXE_GSI_TYPE uInfoType,
  [out] PVOID        pBuffer,
  [in]  ULONG        uBufferLen,
  [out] PULONG       puBufferUsed
);

Parameter

[in] uInfoType

Wählt die zurückgegebenen Informationen aus.

Wert	Bedeutung
PXE_GSI_TRACE_ENABLED 1	Gibt einen BOOL-Wert zurück, der angibt, ob die Ablaufverfolgung für den Server aktiviert ist. TRUE gibt an, dass die Ablaufverfolgung aktiviert ist.
PXE_GSI_SERVER_DUID 2	Gibt ein Bytearray zurück, das der DHCPv6-DUID entspricht, die in Antwortpaketen in der Option OPTION_SERVERID an DHCPv6 PXE-Clients gesendet wird. PXE_GSI_SERVER_DUID kann nicht mit PxeGetServerInfo verwendet werden.

[out] pBuffer

Adresse eines Puffers, der die Ergebnisse der Abfrage empfängt. Größe und Format der Ergebnisse hängen vom Wert des uInfoType-Parameters ab.

[in] uBufferLen

Größe des Puffers, auf den der pBuffer-Parameter verweist.

[out] puBufferUsed

Größe des Puffers, auf den der pBuffer-Parameter verweist.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wdspxe.h
Bibliothek	WdsPxe.lib
DLL	WdsPxe.dll

Weitere Informationen

Serverfunktionen der Windows-Bereitstellungsdienste