IWiaDrvItem::GetFullItemName 메서드(wiamindr_lh.h)

IWiaDrvItem::GetFullItemName 메서드는 경로 정보를 포함하여 항목의 전체 이름을 가져옵니다.

구문

HRESULT GetFullItemName(
  BSTR *__MIDL__IWiaDrvItem0002
);

매개 변수

__MIDL__IWiaDrvItem0002

pbstrFullItemName [out, optional]

항목의 전체 이름을 포함하는 문자열의 주소를 받을 메모리 위치를 가리킵니다.

반환 값

메서드가 성공하면 경로 정보를 포함하여 항목의 전체 이름에 대한 포인터를 pbstrFullItemName 에 저장하고 S_OK 반환합니다. 메서드가 메모리 부족으로 인해 문자열을 할당하지 못하면 E_OUTOFMEMORY 반환합니다. 매개 변수 pbstrFullItemName 이 유효하지 않으면 메서드는 E_INVALIDARG 반환합니다. 다른 이유로 인해 메서드가 실패하면 표준 COM 오류 코드가 반환됩니다.

설명

사용 가능한 메모리가 충분한 경우 이 메서드는 경로 정보를 포함하여 현재 항목의 전체 이름을 포함하는 문자열을 할당합니다. 이 메서드는 pbstrFullItemName 의 문자열에 대한 포인터를 반환합니다. 미니 드라이버는 SysFreeString 함수를 호출하여 문자열에서 사용하는 메모리의 할당을 취소해야 합니다.

pbstrFullItemName 에서 반환된 이름은 드라이버 서비스 라이브러리 함수 wiasCreateDrvItem에서 항목을 처음 만들 때 항목과 연결된 이름입니다.

요구 사항

   
대상 플랫폼 데스크톱
헤더 wiamindr_lh.h(Wiamindr.h 포함)

참고 항목

IWiaDrvItem

wiasCreateDrvItem