TdhEnumerateProviders 함수(tdh.h)
컴퓨터에 등록된 모든 공급자의 목록을 검색합니다.
구문
TDHSTATUS TdhEnumerateProviders(
[out] PPROVIDER_ENUMERATION_INFO pBuffer,
[in, out] ULONG *pBufferSize
);
매개 변수
[out] pBuffer
컴퓨터에서 공개적으로 이벤트를 정의하는 공급자의 배열입니다. 자세한 내용은 PROVIDER_ENUMERATION_INFO 구조를 참조하세요.
[in, out] pBufferSize
pBuffer 버퍼의 크기(바이트)입니다. 함수가 성공하면 이 매개 변수는 사용된 버퍼의 크기를 받습니다. 버퍼가 너무 작으면 함수는 ERROR_INSUFFICIENT_BUFFER 반환하고 이 매개 변수를 필요한 버퍼 크기로 설정합니다. 입력 시 버퍼 크기가 0이면 버퍼에 데이터가 반환되지 않으며 이 매개 변수는 필요한 버퍼 크기를 받습니다.
반환 값
성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 이 함수는 다른 코드 외에도 다음 반환 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| ERROR_INSUFFICIENT_BUFFER | pBuffer 버퍼의 크기가 너무 작습니다. pBufferSize에 설정된 필수 버퍼 크기를 사용하여 새 버퍼를 할당합니다. |
| ERROR_INVALID_PARAMETER | 하나 이상의 매개 변수가 잘못되었습니다. |
설명
TdhEnumerateProvidersForDecodingSource 함수를 호출하여 컴퓨터에 MOF 클래스 또는 매니페스트 파일을 등록한 공급자 목록을 검색합니다.
등록된 이벤트 공급자의 수는 이 함수에 대한 호출 간에 변동될 수 있으므로 반환된 값이 더 이상 ERROR_INSUFFICIENT_BUFFER 않을 때까지 루프에 이 함수를 배치해야 합니다.
예제
공급자를 열거하는 방법을 보여 주는 예제는 공급자 열거를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | tdh.h |
| 라이브러리 | Tdh.lib |
| DLL | Tdh.dll |