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에서 항목을 처음 만들 때 항목과 연결된 이름입니다.

요구 사항

추가 정보

IWiaDrvItem

wiasCreateDrvItem