CM_Get_Device_Interface_AliasA 함수(cfgmgr32.h)

CM_Get_Device_Interface_Alias 함수는 별칭이 있는 경우 지정된 디바이스 인터페이스 instance 별칭을 반환합니다.

구문

CMAPI CONFIGRET CM_Get_Device_Interface_AliasA(
  [in]      LPCSTR pszDeviceInterface,
  [in]      LPGUID AliasInterfaceGuid,
  [out]     LPSTR  pszAliasDeviceInterface,
  [in, out] PULONG pulLength,
  [in]      ULONG  ulFlags
);

매개 변수

[in] pszDeviceInterface

별칭을 검색할 디바이스 인터페이스 instance 이름에 대한 포인터입니다. 호출자는 일반적으로 CM_Get_Device_Interface_List 호출 또는 PnP 알림 구조에서 이 문자열을 수신했습니다.

[in] AliasInterfaceGuid

검색할 별칭의 인터페이스 클래스를 지정하는 GUID에 대한 포인터입니다.

[out] pszAliasDeviceInterface

성공적으로 반환되면 별칭 이름이 포함된 문자열을 가리키는 버퍼에 대한 포인터를 지정합니다. 호출자는 더 이상 필요하지 않은 경우 이 문자열을 해제해야 합니다.

버퍼가 필요합니다. 그렇지 않으면 호출이 실패합니다.

[in, out] pulLength

pszAliasDeviceInterface의 문자 수를 제공하고 별칭 디바이스 인터페이스를 보유하는 데 필요한 문자 수를 받습니다.

입력에서 이 매개 변수는 0보다 커야 합니다.

[in] ulFlags

예약되어 있습니다. 사용하지 마십시오.

반환 값

작업이 성공하면 함수는 CR_SUCCESS 반환합니다. 그렇지 않으면 Cfgmgr32.h에 정의된 CR_ 접두사 오류 코드 중 하나를 반환합니다.

반환 코드	설명
CR_NO_SUCH_DEVICE_INTERFACE	지정된 인터페이스 클래스의 별칭이 없음을 나타내는 것일 수 있습니다.
CR_OUT_OF_MEMORY	메모리가 부족하여 작업을 완료할 수 없습니다.
CR_BUFFER_SMALL	전달된 버퍼가 너무 작습니다.

설명

디바이스 인터페이스는 동일한 기본 디바이스에서 노출되고 인터페이스 참조 문자열이 동일하지만 인터페이스 클래스가 다른 경우 별칭으로 간주됩니다.

pszDeviceInterface 매개 변수는 특정 참조 문자열을 사용하여 특정 인터페이스 클래스에 속하는 특정 디바이스에 대한 instance 디바이스 인터페이스를 지정합니다. CM_Get_Device_Interface_Alias 동일한 디바이스 및 참조 문자열에 대해 instance 다른 디바이스 인터페이스를 반환하지만 다른 인터페이스 클래스가 있는 경우 반환합니다.

예를 들어 내결함성 볼륨의 함수 드라이버는 두 개의 디바이스 인터페이스( 내결함성 볼륨 인터페이스 클래스 중 하나 및 볼륨 인터페이스 클래스 중 하나)를 등록하고 설정할 수 있습니다. 다른 드라이버는 인터페이스 중 하나에 대한 기호 링크를 사용하여 CM_Get_Device_Interface_Alias 호출하고 인터페이스 클래스를 지정하여 다른 인터페이스가 존재하는지 여부를 물어볼 수 있습니다.

NULL 참조 문자열이 있는 두 디바이스 인터페이스는 동일한 기본 디바이스에서 노출되고 인터페이스 클래스 GUID가 다른 경우 별칭입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	cfgmgr32.h(Cfgmgr32.h 포함)
라이브러리	Cfgmgr32.lib