CM_Enumerate_EnumeratorsA 함수(cfgmgr32.h)
CM_Enumerate_Enumerators 함수는 각 열거자의 이름을 제공하여 로컬 컴퓨터의 디바이스 열거자를 열거합니다.
구문
CMAPI CONFIGRET CM_Enumerate_EnumeratorsA(
[in] ULONG ulEnumIndex,
[out] PSTR Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
매개 변수
[in] ulEnumIndex
머신의 디바이스 열거자 목록에 대한 호출자 제공 인덱스입니다. 자세한 내용은 다음 주의 섹션을 참조 하세요 .
[out] Buffer
열거자 이름을 받을 버퍼의 주소입니다. 이 버퍼는 MAX_DEVICE_ID_LEN 크기여야 합니다(또는 버퍼 를 0으로 설정하고 puLength에서 참조하는 위치에서 실제 이름 길이를 가져옵니다).
[in, out] pulLength
버퍼 크기를 저장할 위치의 호출자 제공 주소입니다. 호출자는 버퍼가 가리키는 버퍼의 길이를 제공합니다. 함수는 이 값을 열거자 이름 문자열의 실제 크기로 바꿉니다. 호출자가 제공한 버퍼 길이가 너무 작으면 함수는 필요한 버퍼 크기를 제공하고 CR_BUFFER_SMALL 반환합니다.
[in] ulFlags
사용되지 않음, 0이어야 합니다.
반환 값
작업이 성공하면 함수는 CR_SUCCESS 반환합니다. 그렇지 않으면 Cfgmgr32.h에 정의된 CR_ 접두사 오류 코드 중 하나를 반환합니다.
설명
로컬 머신의 디바이스 열거자를 열거하려면 ulEnumIndex 인덱스 값 0부터 시작하여 CM_Enumerate_Enumerators 반복적으로 호출합니다. 함수가 CR_NO_SUCH_VALUE 반환할 때까지 각 후속 호출을 통해 인덱스 값을 증분합니다.
열거자 이름을 가져온 후에는 이름을 입력으로 사용하여 CM_Get_Device_ID_List 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | cfgmgr32.h(Cfgmgr32.h 포함) |
| 라이브러리 | Cfgmgr32.lib |