NdisOpenConfigurationKeyByName 関数 (ndis.h)

[アーティクル]
08/07/2023

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)