IoWMISuggestInstanceName 함수(wdm.h)

  • 아티클

IoWMISuggestInstanceName 루틴은 드라이버가 디바이스의 WMI instance 이름을 빌드하는 데 사용할 수 있는 기본 이름을 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

성공적으로 완료되면 제안된 instance 이름을 포함하는 UNICODE_STRING 포함하는 버퍼에 대한 포인터입니다. 호출자는 더 이상 필요하지 않은 경우 이 버퍼를 해제해야 합니다.

반환 값

IoWMISuggestInstanceName은 다음 목록에서 상태 코드를 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 WMI가 이 함수를 성공적으로 완료할 수 있음을 나타냅니다.
STATUS_UNSUCCESSFUL
 WMI 서비스를 사용할 수 없음을 나타냅니다.
STATUS_INSUFFICIENT_RESOURCES
 호출자에게 유니코드 문자열이 포함된 버퍼를 제공하는 데 사용할 수 있는 리소스가 부족했음을 나타냅니다.
STATUS_NO_MEMORY
 호출자에게 유니코드 문자열이 포함된 버퍼를 제공하는 데 사용할 수 있는 리소스가 부족했음을 나타냅니다.

설명

CombineNames 매개 변수가 TRUE이면 PhysicalDeviceObject와 SymbolicLinkName을 모두 지정해야 합니다. 그렇지 않으면 그 중 하나만 지정해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000부터 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

추가 정보

IoWMIAllocateInstanceIds