다음을 통해 공유

CM_Enumerate_Enumerators_ExA 함수(cfgmgr32.h)

  • 아티클

[Windows 8 및 Windows Server 2012부터 이 함수는 더 이상 사용되지 않습니다. 대신 CM_Enumerate_Enumerators 사용하세요.]

CM_Enumerate_Enumerators_Ex 함수는 각 열거자의 이름을 제공하여 로컬 또는 원격 머신의 디바이스 열거자를 열거합니다.

구문

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExA(
  [in]           ULONG    ulEnumIndex,
  [out]          PSTR     Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

매개 변수

[in] ulEnumIndex

머신의 디바이스 열거자 목록에 대한 호출자 제공 인덱스입니다. 자세한 내용은 다음 주의 섹션을 참조 하세요 .

[out] Buffer

열거자 이름을 받을 버퍼의 주소입니다. 이 버퍼는 MAX_DEVICE_ID_LEN 크기여야 합니다(또는 버퍼 를 0으로 설정하고 puLength에서 참조하는 위치에서 실제 이름 길이를 가져옵니다).

[in, out] pulLength

버퍼 크기를 저장할 위치의 호출자 제공 주소입니다. 호출자는 버퍼가 가리키는 버퍼의 길이를 제공합니다. 함수는 이 값을 열거자 이름 문자열의 실제 크기로 바꿉니다. 호출자가 제공한 버퍼 길이가 너무 작으면 함수는 필요한 버퍼 크기를 제공하고 CR_BUFFER_SMALL 반환합니다.

[in] ulFlags

사용되지 않음, 0이어야 합니다.

[in, optional] hMachine

CM_Connect_Machine 대한 이전 호출에서 가져온 호출자 제공 컴퓨터 핸들입니다.

참고 이 기능이 제거되었으므로 이 함수를 사용하여 원격 머신에 액세스하는 것은 Windows 8 및 Windows Server 2012부터 지원되지 않습니다.
 

반환 값

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

설명

로컬 또는 원격 머신의 디바이스 열거자를 열거하려면 ulEnumIndex 인덱스 값 0부터 시작하여 함수가 CR_NO_SUCH_VALUE 반환될 때까지 각 후속 호출을 통해 인덱스 값을 증가시키는 CM_Enumerate_Enumerators_Ex 반복적으로 호출합니다.

열거자 이름을 가져온 후에는 이름을 입력으로 사용하여 CM_Get_Device_ID_List 수 있습니다.

원격 머신에 액세스하는 기능은 Windows 8 및 Windows Server 2012 이상 운영 체제에서 제거되었으므로 이러한 버전의 Windows에서 실행할 때 원격 컴퓨터에 액세스할 수 없습니다.

요구 사항

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

추가 정보

CM_Enumerate_Enumerators