IoWMISuggestInstanceName 関数 (wdm.h)
IoWMISuggestInstanceName ルーチンを使用して、ドライバーがデバイスの WMI インスタンス名を構築するために使用できるベース名を WMI が提案するように要求します。
構文
NTSTATUS IoWMISuggestInstanceName(
[in, optional] PDEVICE_OBJECT PhysicalDeviceObject,
[in, optional] PUNICODE_STRING SymbolicLinkName,
[in] BOOLEAN CombineNames,
[out] PUNICODE_STRING SuggestedInstanceName
);
パラメーター
[in, optional] PhysicalDeviceObject
指定した場合は、ドライバーの物理デバイス オブジェクトを指します。
[in, optional] SymbolicLinkName
指定した場合は、 IoRegisterDeviceInterface から返されるシンボリック リンク名を指します。
[in] CombineNames
TRUE の場合、返される推奨名は PhysicalDeviceObject と SymbolicLinkName 情報を組み合わせます。
[out] SuggestedInstanceName
正常に完了すると、推奨されるインスタンス名を含む UNICODE_STRING が含まれるバッファーへのポインター。 呼び出し元は、不要になったときにこのバッファーを解放する責任があります。
戻り値
IoWMISuggestInstanceName は、次の一覧から状態コードを返します。
リターン コード | 説明 |
---|---|
|
WMI がこの関数を正常に完了できたことを示します。 |
|
WMI サービスが使用できないことを示します。 |
|
Unicode 文字列を含むバッファーを呼び出し元に提供するために十分なリソースが使用できなかったことを示します。 |
|
Unicode 文字列を含むバッファーを呼び出し元に提供するために十分なリソースが使用できなかったことを示します。 |
注釈
CombineNames パラメーターが TRUE の場合は、PhysicalDeviceObject と SymbolicLinkName の両方を指定する必要があります。 それ以外の場合は、そのうちの 1 つだけを指定する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 以降で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe |
IRQL | <= APC_LEVEL |