IoWMISuggestInstanceName - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// wdm.h
NTSTATUS IoWMISuggestInstanceName(
[in, optional] PDEVICE_OBJECT PhysicalDeviceObject,
[in, optional] PUNICODE_STRING SymbolicLinkName,
[in] BOOLEAN CombineNames,
[out] PUNICODE_STRING SuggestedInstanceName
);
View the official Windows Driver Kit DDI referenceNo description available.
The IoWMISuggestInstanceName routine is used to request that WMI suggest a base name which a driver can use to build WMI instance names for the device.
PhysicalDeviceObject [in, optional]If supplied, points to the driver's physical device object.
SymbolicLinkName [in, optional]If supplied, points to the symbolic link name returned from IoRegisterDeviceInterface.
CombineNames [in]If TRUE then the suggested names returned will combine the PhysicalDeviceObject and SymbolicLinkName information.
SuggestedInstanceName [out]A pointer to a buffer which upon successful completion will contain a UNICODE_STRING which contains the suggested instance name. The caller is responsible for freeing this buffer when it is no longer needed.
IoWMISuggestInstanceName returns a status code from the following list:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | Indicates that WMI was able to successfully complete this function. |
| STATUS_UNSUCCESSFUL | Indicates that the WMI services are not available. |
| STATUS_INSUFFICIENT_RESOURCES | Indicates that insufficient resources were available to provide the caller with a buffer containing the Unicode string. |
| STATUS_NO_MEMORY | Indicates that insufficient resources were available to provide the caller with a buffer containing the Unicode string. |
If the CombineNames parameter is TRUE then both PhysicalDeviceObject and SymbolicLinkName must be specified. Otherwise, only one of them should be specified.