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 が返した SubKeyHandle を使用して、NdisReadConfiguration、NdisReadNetworkAddress、または NdisWriteConfiguration 関数へのドライバーの呼び出しで割り当てられた NDIS 一時記憶域も解放します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisOpenConfigurationKeyByName (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisOpenConfigurationKeyByName (NDIS 5.1)」を参照) でサポートされています。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| DDI コンプライアンス規則 | Irql_Miscellaneous_Function(ndis) |