IRTC::Configure 메서드

Configure 메서드는 데이터 캡처에 대한 구성 데이터를 제출합니다.

구문

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

매개 변수

hConfigurationBlob [in]

호출자가 구성한 BLOB에 대한 핸들입니다.

hErrorBlob [out]

추가 오류 데이터를 포함하는 오류 BLOB에 대한 핸들입니다.

반환 값

메서드가 성공하면 반환 값이 NMERR_SUCCESS.

메서드가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
NMERR_BLOB_NOT_INITIALIZED	CreateBlob 메서드가 호출되지 않았습니다.
NMERR_INVALID_BLOB	가리키는 개체가 BLOB이 아닙니다.
NMERR_UPLEVEL_BLOB	BLOB 버전 번호가 잘못되었습니다.
NMERR_BLOB_ENTRY_ALREADY_EXISTS	중복 BLOB입니다.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	hConfigurationBlob에서 지정한 구성 BLOB에는 이 작업을 수행하는 데 필요한 항목이 없습니다. hErrorBlob에서 반환된 오류 BLOB을 확인하여 찾을 수 없는 항목을 확인합니다.
NMERR_AMBIGUOUS_SPECIFIER	BLOB 소유자 또는 범주 데이터가 없습니다.
NMERR_BLOB_OWNER_NOT_FOUND	BLOB 소유자 섹션을 찾을 수 없습니다.
NMERR_BLOB_CATEGORY_NOT_FOUND	BLOB 범주 섹션을 찾을 수 없습니다.
NMERR_UNKNOWN_CATEGORY	BLOB 범주 섹션을 찾았지만 이해할 수 없습니다.
NMERR_UNKNOWN_TAG	BLOB 태그 섹션이 발견되었지만 이해되지 않았습니다.
NMERR_BLOB_CONVERSION_ERROR	BLOB이 손상되었습니다.
NMERR_ILLEGAL_TRIGGER	BLOB의 트리거 부분이 손상되었습니다.
NMERR_BLOB_STRING_INVALID	문자열이 null로 종료되지 않습니다.

설명

시작, 중지되었지만 연결이 끊어지지 않은 NPP를 다시 시작하려면 이 메서드를 적용해야 합니다.

hErrorBlob에서 반환된 BLOB 오류에는 네트워크 모니터가 hConfigurationBlob에 지정된 구성 BLOB에서 이해하거나 찾을 수 없는 항목이 포함되어 있습니다. 반환된 오류 BLOB에는 애플리케이션이 문제 해결에 사용할 수 있는 오류 데이터가 포함되어 있습니다. 예를 들어 NMERR_BLOB_ENTRY_DOES_NOT_EXIST 반환되면 네트워크 모니터에서 찾을 수 없는 항목이 반환된 오류 BLOB에 포함됩니다.

요구 사항

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

추가 정보

IRTC

IRTC::Connect

네트워크 모니터 BLOB