NdisOpenConfigurationKeyByIndex 関数 (ndis.h)
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) |