ネットワーク管理機能のバッファー長

このトピックでは、ネットワーク管理 API と共に使用する場合の関数バッファー長の要件について説明します。

ネットワーク管理列挙関数 (およびさまざまなデータ取得関数) を呼び出すときにバッファー サイズを指定するアプリケーションでは、返される情報構造 (または構造体) とそのメンバーが指す文字列を保持するのに十分な大きさのバッファーを指定する必要があります。 使用可能なすべてのエントリを受け取るのに十分な大きさのバッファーを指定しない場合、関数は ERROR_MORE_DATAを返します。 列挙呼び出しでは、部分的なエントリは返されません。

一部のネットワーク管理機能は、アドバイザリの最大データ長パラメーター prefmaxlen を受け取ります。 このパラメーターを使用すると、アプリケーションは、サーバーが関数呼び出しから返すバイト数を提案できます。

prefmaxlen パラメーターにMAX_PREFERRED_LENGTH値を指定すると、ネットワーク管理機能によってデータに必要なメモリ量が割り当てられます。

詳細については、「 ネットワーク管理機能バッファー」を参照してください。