次の方法で共有


Dhcpv6RequestParams 関数 (dhcpv6csdk.h)

Dhcpv6RequestParams 関数は、DHCPv6 クライアント キャッシュまたは DHCPv6 サーバーから直接オプションを要求します。

構文

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

パラメーター

forceNewInform

この値が TRUE に設定されている場合、使用可能なキャッシュされた情報はすべて無視され、新しい情報が要求されます。 それ以外の場合、要求はキャッシュされた情報がない場合にのみ送信されます。

reserved

将来利用するために予約されています。 NULL に設定する必要があります。

adapterName

この要求の対象となるアダプターの GUID。 このパラメーターは NULL にすることはできません。

classId

ワイヤ 上で 送信するために使用するバイナリ ClassId 情報を含むDHCPV6CAPI_CLASSID構造体へのポインター。 このパラメーターは省略可能です。

recdParams

DHCPV6 サーバーから受信するパラメーターを含む DHCPV6CAPI_PARAMS_ARRAY 構造体。

buffer

recdParams の一部のポインターによって返される情報を格納するバッファー。

pSize

バッファーのサイズ。 関数がERROR_MORE_DATAを返すと、このパラメーターには、操作を完了するために必要なサイズ (バイト単位) が含まれます。 関数が成功した場合、このパラメーターには使用されたバイト数が含まれます。

戻り値

正常に完了したときにERROR_SUCCESSを返します。

リターン コード 説明
ERROR_INVALID_PARAMETER
次のいずれかの条件に該当する場合に返されます。
  • 予約にはNULL ではない値があります。
  • AdapterNameNULL です。 または、GUID が指定されたアダプターが見つかりません。
  • pSizeNULL です
  • bufferNULL です
ERROR_MORE_DATA
この API の呼び出しは 、Buffer パラメーターに割り当てられたメモリが不足し、 pSize には必要な実際のメモリ サイズが含まれています。
ERROR_INVALID_NAME
AdapterName が正しい形式ではありません。 形式は である必要があります。 {00000000-0000-0000-0000-000000000000}

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー dhcpv6csdk.h
Library Dhcpcsvc6.lib
[DLL] Dhcpcsvc6.dll