NdisOpenConfigurationKeyByIndex 関数 (ndis.h)

[アーティクル]
02/26/2024

NdisOpenConfigurationKeyByIndex 関数は、呼び出し元が指定したハンドルによって指定された、指定された開いているレジストリキーのサブキーを開きます。

構文

void NdisOpenConfigurationKeyByIndex(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  ULONG        Index,
  [out] PNDIS_STRING KeyName,
  [out] PNDIS_HANDLE KeyHandle
);

パラメーター

[out] Status

呼び出し元が指定した変数へのポインター。この関数は、指定されたレジストリキーを開こうとした状態を返します。可能な戻り値は、次のいずれかです。

NDIS_STATUS_SUCCESS

NDIS は、 KeyName および Index で指定されたサブキーにアクセスして初期化しました。

NDIS_STATUS_FAILURE

キーを開くことができませんでした。

[in] ConfigurationHandle

サブキーを開くレジストリキーへのハンドル。通常、 ConfigurationHandle はによって返されます。 NdisOpenConfigurationEx 関数。

[in] Index

開くサブキーのインデックス。この 0 から始まる値は、 ConfigurationHandle で既に開かれているキーの下で開くサブキーを指定します。

[out] KeyName

呼び出し元が指定したバッファーを含むNDIS_STRING型へのポインター。この関数は、システムの既定の文字セット内のカウントされた文字列を返します。この文字列は、呼び出しが成功した場合に開かれたサブキーの名前を指定します。 Microsoft Windows 2000 以降のドライバーの場合、この文字列には Unicode 文字が含まれます。つまり、Windows 2000 以降の場合、NDIS はNDIS_STRING型を UNICODE_STRING 型として定義します。

[out] KeyHandle

呼び出しが成功した場合に、この関数が開いているサブキーへのハンドルを返す呼び出し元が指定した変数へのポインター。

戻り値

なし

解説

NdisOpenConfigurationKeyByIndex を使用すると、ドライバーは、そのインストールファイルがレジストリサブキーに格納されている構成情報にアクセスできます。

NdisOpenConfigurationKeyByIndex に渡される ConfigurationHandle には、呼び出し元によって既に開かれているレジストリキーへの任意の有効なハンドルを指定できます。 NdisOpenConfigurationKeyByIndex は、有効なサブキーの構成情報を返します
ConfigurationHandle 。

NdisOpenConfigurationKeyByIndex はインデックスを介してサブキーを参照するため、ドライバーはサブキー名を指定する必要はありません。ドライバーは、関数がNDIS_STATUS_FAILUREを返すまでインデックスをインクリメントした後に NdisOpenConfigurationKeyIndex を繰り返し呼び出すことで、一連のレジストリサブキーをシーケンス処理できるため、開くサブキーがこれ以上ないことを示します。

ドライバーが使用され、レジストリに格納されている構成情報を変更した後、NdisOpenConfigurationKeyByIndex から取得されたハンドルを解放するには、NdisCloseConfiguration 関数を呼び出す必要があります。 NdisCloseConfiguration は、NdisOpenConfigurationKeyByIndex が返した SubKeyHandle を使用して、NdisReadConfiguration、NdisReadNetworkAddress、または NdisWriteConfiguration 関数のドライバーの呼び出しに割り当てられた一時記憶域も解放します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisOpenConfigurationKeyByIndex (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisOpenConfigurationKeyByIndex (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	< DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_Miscellaneous_Function(ndis)