Dhcpv6RequestParams-Funktion (dhcpv6csdk.h)

  • Artikel

Die Dhcpv6RequestParams-Funktion fordert Optionen aus dem DHCPv6-Clientcache oder direkt vom DHCPv6-Server an.

Syntax

DWORD Dhcpv6RequestParams(
  BOOL                    forceNewInform,
  LPVOID                  reserved,
  LPWSTR                  adapterName,
  LPDHCPV6CAPI_CLASSID    classId,
  DHCPV6CAPI_PARAMS_ARRAY recdParams,
  LPBYTE                  buffer,
  LPDWORD                 pSize
);

Parameter

forceNewInform

Wenn dieser Wert auf TRUE festgelegt ist, werden alle verfügbaren zwischengespeicherten Informationen ignoriert, und es werden neue Informationen angefordert. Andernfalls wird die Anforderung nur gesendet, wenn keine zwischengespeicherten Informationen vorhanden sind.

reserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

adapterName

GUID des Adapters, für den diese Anforderung vorgesehen ist. Dieser Parameter darf nicht NULL sein.

classId

Zeiger auf eine DHCPV6CAPI_CLASSID-Struktur , die die binären ClassId-Informationen enthält, die zum Senden an die Leitung verwendet werden sollen. Dieser Parameter ist optional.

recdParams

Eine DHCPV6CAPI_PARAMS_ARRAY-Struktur , die die Parameter enthält, die vom DHCPV6-Server empfangen werden sollen.

buffer

Ein Puffer, der Informationen enthält, die von einigen Zeigern in recdParams zurückgegeben werden.

pSize

Größe des Puffers. Wenn die Funktion ERROR_MORE_DATA zurückgibt, enthält dieser Parameter die Größe in Bytes, die zum Abschließen des Vorgangs erforderlich ist. Wenn die Funktion erfolgreich ist, enthält dieser Parameter die Anzahl der verwendeten Bytes.

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 Wird zurückgegeben, wenn eine der folgenden Bedingungen zutrifft:
  • reserved hat einen Wert, der nicht NULL ist.
  • AdapterName ist NULL. Oder es wird kein Adapter mit der angegebenen GUID gefunden.
  • pSize ist NULL.
  • buffer ist NULL.
ERROR_MORE_DATA
 Der Aufruf dieser API wurde mit unzureichendem Arbeitsspeicher für den Buffer-Parameter durchgeführt, während pSize die tatsächliche erforderliche Arbeitsspeichergröße enthält.
ERROR_INVALID_NAME
 AdapterName hat nicht das richtige Format. Es sollte das folgende Format aufweisen: {00000000-0000-0000-0000-000000000000}.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dhcpv6csdk.h
Bibliothek Dhcpcsvc6.lib
DLL Dhcpcsvc6.dll