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 대한 이전 호출에서 가져온 호출자 제공 컴퓨터 핸들입니다.
반환 값
작업이 성공하면 함수는 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 |