TcQueryInterface 함수(traffic.h)

TcQueryInterface 함수는 관련 인터페이스별 매개 변수에 대한 트래픽 제어를 쿼리합니다. 트래픽 제어 매개 변수는 GUID(Globally Unique Identifier)를 제공하여 쿼리됩니다. NotifyChange 매개 변수를 TRUE로 설정하면 지정된 GUID에서 이벤트 알림을 사용할 수 있으며, 그 후에는 쿼리된 매개 변수가 변경될 때마다 알림 이벤트가 클라이언트로 전송됩니다. 클라이언트가 알림을 요청할 수 있는 GUID는 GUID 항목에 있습니다. "알림"이라는 열은 알림에 사용할 수 있는 GUID를 표시합니다.

구문

ULONG TcQueryInterface(
  [in]      HANDLE  IfcHandle,
  [in]      LPGUID  pGuidParam,
  [in]      BOOLEAN NotifyChange,
  [in, out] PULONG  pBufferSize,
  [out]     PVOID   Buffer
);

매개 변수

[in] IfcHandle

쿼리할 인터페이스와 연결된 핸들입니다. 이 핸들은 TcOpenInterface 함수에 대한 이전 호출을 통해 가져옵니다.

[in] pGuidParam

쿼리되는 트래픽 제어 매개 변수에 해당하는 GUID(Globally Unique Identifier)에 대한 포인터입니다.

[in] NotifyChange

쿼리되는 매개 변수에 대한 트래픽 제어에서 알림을 요청하는 데 사용됩니다. TRUE이면 트래픽 제어는 pGuidParam에 제공된 GUID에 해당하는 매개 변수를 변경하면 ClNotifyHandler 함수를 통해 클라이언트에 알립니다. 알림은 기본적으로 꺼져 있습니다.

[in, out] pBufferSize

버퍼의 크기를 바이트 단위로 나타냅니다. 입력의 경우 이 값은 호출자가 할당한 버퍼의 크기입니다. 출력의 경우 이 값은 트래픽 제어에서 사용하는 버퍼의 실제 크기(바이트)입니다.

[out] Buffer

반환된 데이터가 기록될 클라이언트 할당 버퍼에 대한 포인터입니다.

반환 값

요청된 알림 상태와 관련하여 반환 값만 NO_ERROR 요청된 알림 상태가 적용됩니다. TcQueryInterface 함수 호출에서 NO_ERROR 이외의 반환 값이 반환되면 요청된 알림 상태 변경이 허용되지 않습니다.

반환 코드	설명
NO_ERROR	함수가 오류 없이 실행되었습니다.
ERROR_INVALID_HANDLE	잘못된 인터페이스 핸들입니다.
ERROR_INVALID_PARAMETER	잘못된 매개 변수 또는 NULL 매개 변수입니다.
ERROR_INSUFFICIENT_BUFFER	버퍼가 너무 작아서 결과를 저장할 수 없습니다.
ERROR_NOT_SUPPORTED	제공된 GUID에 대한 쿼리는 제공된 인터페이스에서 지원되지 않습니다.
ERROR_WMI_GUID_NOT_FOUND	디바이스가 이 GUID에 등록하지 않았습니다.
ERROR_WMI_INSTANCE_NOT_FOUND	인터페이스가 닫히는 중이기 때문에 instance 이름을 찾을 수 없습니다.

설명

참고TcQueryInterface 함수를 사용하려면 관리 권한이 필요합니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	traffic.h
라이브러리	Traffic.lib
DLL	Traffic.dll

추가 정보

ClNotifyHandler

TcEnumerateInterfaces

TcRegisterClient