NdisOpenConfigurationKeyByName 関数 (ndis.h)
NdisOpenConfigurationKeyByName 関数は、呼び出し元が指定したハンドルによって指定された特定の開いているレジストリ キーの名前付きサブキーを開きます。
構文
void NdisOpenConfigurationKeyByName(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING SubKeyName,
[out] PNDIS_HANDLE SubKeyHandle
);
パラメーター
[out] Status
呼び出し元が指定した変数へのポインター。この関数は、レジストリ キーを開こうとした場合の状態を返します。 可能な戻り値は、次のいずれかです。
NDIS_STATUS_SUCCESS
NDIS は、subKeyName で指定されたサブキー 初期化されました。
NDIS_STATUS_FAILURE
キーを開くことができませんでした。
[in] ConfigurationHandle
サブキーを開くレジストリ キーのハンドル。 通常、ConfigurationHandle はNdisOpenConfigurationEx 関数を します。
[in] SubKeyName
開くレジストリ サブキーの名前を指定する、システムの既定の文字セット内の呼び出し元が指定したカウントされた文字列を含むNDIS_STRING型へのポインター。 Microsoft Windows 2000 以降のドライバーの場合、この文字列には Unicode 文字が含まれます。 つまり、Windows 2000 以降では、NDIS はNDIS_STRING型を UNICODE_STRING 型として定義します。
[out] SubKeyHandle
呼び出し元が指定した変数へのポインター。この関数は、この呼び出しが成功した場合に、開かれたサブキーへのハンドルを返します。
戻り値
何一つ
備考
NdisOpenConfigurationKeyByName を使用すると、ドライバーはレジストリ内の名前付きサブキーに格納されている構成情報にアクセスできます。
NdisOpenConfigurationKeyByName に渡される ConfigurationHandle には、呼び出し元によって既に開かれているレジストリ キーへの任意の有効なハンドルを指定できます。 NdisOpenConfigurationKeyByName は、有効な ConfigurationHandle に関連するサブキーの構成情報を返します。
ドライバーが使用され、場合によってはレジストリ構成情報を変更した後、ndisOpenConfigurationKeyByName から取得したハンドルを解放するには、NdisCloseConfiguration 関数呼び出す必要があります。 NdisCloseConfiguration は、ndisOpenConfigurationKeyByName が返された NdisReadConfiguration、NdisReadNetworkAddress、または SubKeyHandle を使用して NdisWriteConfiguration 関数を するドライバーの呼び出しで割り当てられた一時記憶域も解放します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisOpenConfigurationKeyByName (NDIS 5.1) を参照) でサポートされています。 Windows XP で NDIS 5.1 ドライバー (NdisOpenConfigurationKeyByName (NDIS 5.1) を参照) でサポートされています。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ndis.h (Ndis.h を含む) |
| ライブラリ | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | Irql_Miscellaneous_Function(ndis) |
関連項目
NdisCloseConfiguration の
NdisOpenConfigurationEx の
NdisOpenConfigurationKeyByIndex のNdisReadConfiguration の
NdisWriteConfiguration の