WdfRegistryQueryULong 関数 (wdfregistry.h)
[KMDF と UMDF に適用]
WdfRegistryQueryULong メソッドは、指定されたレジストリ値に現在割り当てられている符号なし長い単語 (REG_DWORD) データを取得し、指定した場所にデータをコピーします。
構文
NTSTATUS WdfRegistryQueryULong(
[in] WDFKEY Key,
[in] PCUNICODE_STRING ValueName,
[out] PULONG Value
);
パラメーター
[in] Key
開かれたレジストリ キーを表すレジストリ キー オブジェクトへのハンドル。
[in] ValueName
レジストリ値の名前を含む UNICODE_STRING 構造体へのポインター。
[out] Value
ValueName が指定するレジストリ値に割り当てられているデータを受け取る場所 ポインター。
戻り値
WdfRegistryQueryULong は、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは次のいずれかの値を返す可能性があります。
| リターン コード | 形容 |
|---|---|
|
IRQL = PASSIVE_LEVEL で WdfRegistryQueryULong が呼び出されませんでした。 |
|
無効なパラメーターが指定されました。 |
|
操作を完了するためのメモリが不足していました。 |
|
ドライバーが、KEY_QUERY_VALUE、KEY_READ、またはKEY_ALL_ACCESSアクセス権を持つレジストリ キーを開けませんでした。 |
|
ValueName パラメーターが指定したレジストリ値のデータ型がREG_DWORDされませんでした。 |
|
レジストリ値を使用できませんでした。 |
このメソッドは、他のNTSTATUS 値を返す場合もあります。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
備考
レジストリ キー オブジェクトの詳細については、「WDF ドライバーでのレジストリの使用」を参照してください。
例
次のコード例では、NumberOfThings 値に現在割り当てられているデータを取得します。
NTSTATUS status;
ULONG value;
DECLARE_CONST_UNICODE_STRING(valueName, L"NumberOfThings");
status = WdfRegistryQueryULong(
hKey,
&valueName,
&value
);
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| 最小 KMDF バージョン | 1.0 |
| UMDF の最小バージョン を する | 2.0 |
| ヘッダー | wdfregistry.h (Wdf.h を含む) |
| ライブラリ | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
関連項目
WdfRegistryQueryMemory の
WdfRegistryQueryMultiString の
WdfRegistryQueryValue を する