IESP::Configure 메서드

Configure 메서드는 캡처에 대한 구성 정보를 제출합니다.

구문

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

매개 변수

hConfigurationBlob [in]

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

hErrorBlob [out]

추가 오류 정보가 포함된 오류 BLOB에 대한 핸들입니다. 오류 BLOB의 내용에 대한 자세한 내용은 이 항목의 설명 섹션을 참조하세요.

반환 값

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

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

반환 코드	설명
NMERR_NOT_CONNECTED	NPP가 네트워크에 연결되어 있지 않습니다.
NMERR_NOT_ESP	NPP는 네트워크에 연결되어 있지만 IESP::Connect 메서드와는 연결되지 않습니다.
NMERR_CAPTURING	NPP는 캡처 세션이 시작되었다고 보고합니다.
NMERR_ILLEGAL_TRIGGER	구성 BLOB의 트리거 부분이 손상되었습니다.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	hConfigurationBlob에 지정된 구성 BLOB에 이 작업을 수행하는 데 필요한 항목이 없습니다. hErrorBlob에서 반환된 BLOB 오류를 확인하여 찾을 수 없는 항목을 확인합니다.
NMERR_BLOB_CONVERSION_ERROR	BLOB이 손상되었습니다.
NMERR_BLOB_NOT_INITIALIZED	CreateBlob 메서드가 호출되지 않았습니다.
NMERR_INVALID_BLOB	가리키는 개체가 BLOB이 아닙니다.
NMERR_BLOB_STRING_INVALID	문자열이 null로 종료되지 않습니다.
NMERR_UPLEVEL_BLOB	BLOB 버전 번호가 잘못되었습니다.
NMERR_OUT_OF_MEMORY	메모리를 사용할 수 없습니다. 창을 종료하여 리소스를 확보합니다.
NMERR_TIMEOUT	요청 시간이 초과되었습니다.

설명

시작 및 중지되었지만 연결이 끊어지지 않은 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