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を返します。
リターン コード | 説明 |
---|---|
|
次のいずれかの条件に該当する場合に返されます。
|
|
この API の呼び出しは 、Buffer パラメーターに割り当てられたメモリが不足し、 pSize には必要な実際のメモリ サイズが含まれています。 |
|
AdapterName が正しい形式ではありません。 形式は である必要があります。 {00000000-0000-0000-0000-000000000000} |
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | dhcpv6csdk.h |
Library | Dhcpcsvc6.lib |
[DLL] | Dhcpcsvc6.dll |