콜백 함수 구성

Configure 함수는 전문가 DLL 내에서 전문가를 구성합니다.

전문가는 Configure 함수를 구현해야 합니다. 함수 호출이 수신되면 전문가는 사용자가 구성 가능한 항목을 변경할 수 있는 대화 상자를 표시합니다.

구문

BOOL WINAPI Configure(
  _In_    HEXPERTKEY         hExpertKey,
  _Inout_ PEXPERTCONFIG      *ppConfig,
  _In_    PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_    DWORD              StartupFlags,
  _In_    HWND               hWnd
);

매개 변수

hExpertKey [in]

고유 전문가 식별자입니다.

고유 식별자는 모든 전문가별 네트워크 모니터 함수에 다시 전달됩니다. 식별자는 Run 함수에 전달된 것과 동일한 전문가 키가 아닐 수 있습니다. 구성 호출에서 전문가 키를 저장하지 마세요.

ppConfig [in, out]

입력 시 EXPERTCONFIG 구조체에 대한 포인터에 대한 포인터입니다.

성공적으로 종료되면 참조된 EXPERTCONFIG 구조체에 새 구성 데이터가 포함됩니다.

pExpertStartupInfo [in]

전문가가 시작될 때 포커스가 있는 캡처 요소에 대한 포인터입니다.

StartupFlags [in]

전문가가 pExpertStartupInfo 매개 변수를 사용하는 방법을 나타내는 플래그입니다. 정의된 유일한 플래그는 EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA. 플래그는 전문가가 전달된 ppConfig 매개 변수 대신 pExpertStartupInfo 매개 변수를 사용한다는 것을 나타냅니다. 일반적으로 상황에 맞는 메뉴에서 전문가를 시작할 때 플래그를 설정합니다.

hWnd [in]

부모 창에 대한 핸들입니다. 핸들을 사용하여 대화 상자를 엽니다.

반환 값

함수가 성공하면(즉, 현재 구성이 있는 경우) 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다.

설명

네트워크 모니터는 전문가의 현재 구성(있는 경우)을 사용하여 Configure 함수를 호출합니다. 전문가는 구성 가능한 항목을 변경할 수 있는 대화 상자를 표시합니다.

ppConfig가 전달되고 네트워크 모니터에 지정된 전문가에 대해 저장된 구성이 없는 경우 매개 변수 값은 NULL일 수 있습니다. 이 경우 Configure 함수는 하드 코딩된 기본값(또는 시작 정보를 사용하여)을 가정하여 대화 상자를 엽니다.

구성 데이터는 Configure 함수가 반환되고 NULL이 전달된 경우에도 NULL일 수 있습니다. 이 상황은 네트워크 모니터에 저장된 기본값이 없으며 사용자가 취소를 누를 때 발생합니다.

EXPERTCONFIG 데이터 구조의 시작 부분에는 구조 크기 정보를 저장하는 Private 섹션이 포함되어 있습니다. EXPERTCONFIG 구조체의 크기에는 구조체의 시작 부분에 표시되는 예약된 DWORD 길이가 포함되어야 합니다. 예를 들어 구성 데이터에 20바이트의 스토리지 공간이 필요한 경우 데이터를 저장하기 위해 24바이트를 할당합니다. ppConfig가 NULL인 경우 Configure 함수는 ExpertAllocMemory 함수를 호출하여 올바른 크기의 새 구성을 할당합니다. 버퍼가 전문가 데이터를 보유하기에 충분하지 않은 경우 전문가는 ExpertReallocMemory 함수를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Netmon.h