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

추가 정보

CM_Enumerate_Enumerators_Ex